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

Аудитории

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

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

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

Механизм пагинации реализован и действует всегда. 

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

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

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

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

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

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