アプリリストAPI：アドネットワーク向け

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

メソッド

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

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

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

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

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

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

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

ページネーションのlinksのJSON例

• 次の例は、最初のリクエストの結果を含んでおり、データセクション（非表示）に2つのレコードを含む2番目のリクエストで構成されています。 
• 返されるレコードの総数は６です。
• 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"
           }
}