API-запрос состоит из метода, пути, обязательного параметра capabilities и необязательных параметров пагинации. Токен содержится в заголовке авторизации. 

Аудитории

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

Обязательные параметры для получения списка приложений

Механизм пагинации

Реализован механизм пагинации, который всегда активен. 

Принципы пагинации: 

• Возвращает до 1 000 записей за один запрос (страницу).
• Ответы JSON содержат следующие ключи, связанные с пагинацией:
  • meta.total_items: количество записей, возвращаемых всеми страницами в совокупности. Это количество приложений, для которых вам предоставлены запрашиваемые возможности.
  • Ссылки пагинации (показанные в JSON ниже) содержат следующие ключи:
    • links.prev: если был предыдущий запрос, то запрос, использованный для формирования предыдущей страницы.
    • links.self: текущий запрос — запрос, использованный для формирования текущего JSON (страницы)
    • links.next: запрос, необходимый для получения следующей страницы. Если ключ next отсутствует, значит это последняя страница. 

 Используйте один из следующих методов контроля пагинации:

• [Практические рекомендации] Используйте ссылки в JSON: если ключ links.next существует, используйте его для создания запроса на получение следующей страницы. Продолжайте, пока не получите JSON без ключа links.next.
• Программно реализуйте параметры limit и offset вместе с ключом total_items.

Пример JSON со ссылками пагинации

• В следующем примере показан результат первого запроса, состоящий из второго запроса, содержащего две записи в разделе данных (не отображаются).  
• Общее количество возвращаемых записей — 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"
           }
}