API リクエストは、メソッド、経路、必須の機能パラメーター、オプションのページネーションパラメーターで構成されています。また、API トークンは認証ヘッダーに含まれます。  

メソッド

GET https://hq1.appsflyer.com/api/mng/apps?capabilities={capabilities} 

必須パラメーター

ページネーションの仕組みについて

随時機能するページネーションの仕組みが実装されています。  

ページネーションの仕様： 

• リクエスト(ページ)毎に最大1,000レコードまで返します。
• レスポンスJSON には、以下のページネーション関連のキーが含まれています：
  • meta.total_items:全ページ合算でのレコード数です。これはあなたが 機能 権限を付与されているアプリの数を示しています。
  • ページネーションリンク(下記 JSON を参照)には、以下のキーが含まれます：
    
    • links.prev:それよりも前のリクエストがあった場合 - 前のページを生成するために使用されたリクエストが入ります。
    • links.self:現在のリクエスト：現在の JSON （ページ）を生成するために使用されたリクエスト
    • links.next:次のページを取得するためのリクエストです。次へのキーがない場合は、これが最終ページです。 

次のいずれかのページネーションの制御方法を使用してください。

• [ベストプラクティス] JSON 内のリンクを使用する：links.next キーが存在する場合は、それを使用して次のページを取得するリクエストを作成します。links.nextのkeyがないJSONを受け取るまでは、この作業を続けてください。
• limitとoffsetのパラメータをtotal_itemsのkeyを組み合わせたプログラムを実装してください。

ページネーションリンク JSON の例

• 次の例は、最初のリクエストの結果を含んでおり、データセクション（非表示）に2つのレコードを含む2番目のリクエストで構成されています。  
• 返されるレコードの総数は6です。
• links.nextのkeyには次のページ（レコード5と6）を返すリクエストが含まれています。  

{                                                                                         
    "data": {[...]},   
    "meta": {
        "total_items": 6
    },
    "links": {
        "prev": "https://hq1.appsflyer.com/api/mng/apps?capabilities=protect_360&offset=0&limit=2",
        "self": "https://hq1.appsflyer.com/api/mng/apps?capabilities=protect_360&offset=2&limit=2",
        "next": "https://hq1.appsflyer.com/api/mng/apps?capabilities=protect_360&offset=4&limit=2"
    }
}

ページネーション機能のパラメータ（任意）

Curl リクエスト

この例は、任意のページネーションパラメーターを含む完全なコール内容が記載されています。 

curl --location --request GET 'https://hq1.appsflyer.com/api/mng/apps?capabilities=protect_360&limit=1000&offset=0' \
-H 'Authorization: Bearer {API V2.0 token available to the admin in the dashboard.}' \

JSON レスポンス

{
    "data": [
        {
            "id": "com.appsflyer.xpend_qa1",
            "type": "app",
            "attributes": {
                "name": "com.appsflyer.xpend_qa1",
                "platform": "android",
                "currency": "USD",
                "time_zone": "UTC"
            }
        },
        {
            "id": "com.abc.app",
            "type": "app",
            "attributes": {
                "name": "com.abc.app",
                "platform": "android",
                "currency": "USD",
                "time_zone": "UTC",
                "enable_retargetting": true
            }
        },
        {
            "id": "com.xyz.app",
            "type": "app",
            "attributes": {
                "name": "com.xyz.app",
                "platform": "android",
                "currency": "JPY",
                "time_zone": "UTC"
            }
        }
    ],
    "meta": {
        "total_items": 3
    },
    "links": {
        "self": "https://hq1.appsflyer.com/api/mng/apps?capabilities=protect_360&offset=0&limit=1000"
           }
}