A solicitação da API consiste no método, no caminho, no parâmetro obrigatório capabilities e nos parâmetros opcionais de paginação. O token está contido no cabeçalho de autorização. 

Mensuração

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

Parâmetros obrigatórios para obter a lista de aplicativos

Mecanismo de paginação

Um mecanismo de paginação, sempre operacional, é implementado. 

Princípios de paginação: 

• Retorna até 1.000 registros por solicitação (página).
• Os JSONs de resposta contêm as seguintes chaves relacionadas à paginação:
  • meta.total_items: O número de registros a serem retornados por todas as páginas combinadas. Isso representa o número de aplicativos para os quais você recebeu as capacidades consultadas.
  • Os links de paginação (mostrados no JSON a seguir) têm as seguintes chaves:
    • links.prev: Se houve uma solicitação anterior: a solicitação usada para gerar a página anterior.
    • links.self: A solicitação atual: a solicitação usada para gerar o JSON atual (página)
    • links.next: A solicitação necessária para obter a próxima página. Se não houver a próxima chave, esta é a última página. 

 Use um dos seguintes métodos de controle de paginação:

• [Melhores práticas] Use os links no JSON: se a chave links.next existir, use-a para criar uma solicitação para obter a próxima página. Continue fazendo isso até receber um JSON sem uma chave links.next.
• Implemente programaticamente os parâmetros limit e offset em conjunto com a chave total_items.

Exemplo de JSON de links de paginação

• O exemplo a seguir contém o resultado da primeira solicitação, consistindo na resposta à segunda solicitação, que contém dois registros na seção de dados (não exibida). 
• O número total de registros a serem retornados é 6.
• A chave links.next contém a solicitação que retorna a próxima página — registros 5 e 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"
    }
}

Parâmetros do mecanismo de paginação (opcional)

Solicitação Curl

Este exemplo inclui uma chamada completa, inclusive parâmetros de paginação opcionais. 

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.}' 

Resposta 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"
           }
}