APIリクエストには、メソッド、パス、必須のcapabilitiesパラメータ、および任意のページネーション用パラメータを指定します。トークンはAuthorizationヘッダーに指定します。 

メソッド

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

アプリ一覧の取得に必要なパラメータ

ページネーションの仕組み

このAPIでは、データを複数のページに分けて取得するページネーションが常に適用されます。 

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

• 1回のリクエスト（1ページ）で、最大1,000件のレコードが返されます。
• JSONレスポンスには、ページネーションに関する以下のキーが含まれます。
  • meta.total_items：すべてのページを合わせた、取得対象のレコード数です。指定したcapabilitiesに該当する権限または連携設定が有効なアプリの数を表します。
  • ページネーション用のリンクには、以下のキーが含まれます。後述のJSON例も参照してください。
    • links.prev：前のページがある場合に、そのページの取得に使用したリクエストを示します。
    • links.self：現在のJSON（ページ）の取得に使用したリクエストを示します。
    • links.next：次のページを取得するためのリクエストを示します。 nextキーがない場合は、最後のページです。 

 ページネーションは、以下のいずれかの方法で制御します。

• ［推奨］JSON内のリンクを使用する：links.nextキーがある場合は、その値を使用して次のページを取得するリクエストを作成します。 links.nextキーを含まないJSONが返されるまで、この処理を繰り返します。
• limitパラメータとoffsetパラメータをtotal_itemsキーと組み合わせて使用し、プログラム側でページネーションを制御します。

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

• 以下の例は、最初のリクエストの結果を示したものです。2回目のリクエストに対応し、dataセクションには2件のレコードが含まれています（dataセクションの表示は省略）。 
• 取得対象のレコード数は、全部で6件です。
• links.nextキーには、次のページの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"
           }
}