アプリ所有者向けアプリリスト API

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

メソッド

GET https://hq1.appsflyer.com/api/mng/apps

アプリリストの必須パラメーターの取得：

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

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

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

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

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

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

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

• 次の例には、データセクションの2つのレコードで構成される2回目のリクエストの結果が含まれています (表示されていません)。 
• 返されるレコードの総数は6です。
• links.next キーには、2ページ目 (レコード5と6) を返すリクエストが含まれています。 

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

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

Curl リクエスト

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

cURL --location --request GET 'https://hq1.appsflyer.com/api/mng/apps?limit=1000&offset=0' \
-H 'Authorization: Bearer {API V2.0 token having more than 700 characters 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.def.app",
            "type": "app",
            "attributes": {
                "name": "com.def.app",
                "platform": "android",
                "currency": "JPY",
                "time_zone": "UTC"
            }
        }
    ],
    "meta": {
        "total_items": 6
    },
    "links": {
        "self": "https://hq1.appsflyer.com/api/mng/apps?offset=0&limit=1000"
           }
}