Como podemos ajudar?

API de lista de aplicativos para proprietários de aplicativos

  • Atualizado

Resumo: Recupere os aplicativos ativos e pendentes associados à sua conta da AppsFlyer.

mceclip0.png

Se você for uma ad network, use a API de lista de aplicativos para ad networks.

Leitura adicional: Lista de APIs para anunciantes

Obter a API de lista de aplicativos

As seções a seguir incluem as informações necessárias para usar a API. 

Noções básicas para obter a lista de aplicativos

Noções básicas da lista de APIs

Categoria Item A descrição
Solicitação Método HTTP BAIXAR
Caminho https://hq1.appsflyer.com/api/mng/apps
Cabeçalho de autorização 
 Tempo de Resultados Retorna em um JSON
Limite de solicitação
  • 20 solicitações/minuto
  • 100 solicitações/dia
Limite de registros 1.000 registros/solicitação. Se houver mais de 1.000 registros a serem retornados, use solicitações de paginação subsequentes descritas neste artigo.

Solicitação de API

A solicitação da API consiste no método, caminho, parâmetro obrigatório de capabilities e 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

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

Parâmetro de consulta A descrição
   Não há parâmetros de consulta obrigatórios para esta API


Mecanismo de paginação

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

Princípios da 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 capabilities sendo 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, usada para gerar o JSON (página) atual
      • links.next: a solicitação necessária para obter a próxima página. Se não houver uma chave next , 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 a 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 segunda solicitação, composto por dois registros na seção de dados (não exibida). 
  • O número total de registros a retornar é 6.
  • A chave links.next contém a solicitação que retorna a segunda página: registros 5 e 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"
    }
}

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

Parâmetro de consulta A descrição
limite

Número de registros retornados por chamada

  • Máximo: 1,000
  • Se você não enviarlimit, ele será definido automaticamente como 1,000.
  • Exemplo: limit=2
  • Obrigatório: Não
offset

O primeiro registro a ser retornado na chamada. Os números dos registros começam em 0. 

  • Se você não enviar offset, ele será definido automaticamente como 0.
  • Exemplo: offset=2
  • Obrigatório: Não

Resposta JSON

Chave A descrição
id ID do aplicativo, por exemplo: id123456789, com.myapp.com
Tipo Sempre retornar app 
coluna Nome da aplicação
platforma as integrações de SDK do iOS e Android
símbolos monetários Código de moeda específico do aplicativo 
time_zone Fuso horário específico do app
total_items Número de aplicativos na conta
links

Mecanismo de paginação (explicado na seção de parâmetros)

  • prev: a chamada usada para gerar a página anterior
  • self: a chamada usada para gerar a página atual
  • next: a chamada usada para gerar a próxima página

Exemplo de cURL e resposta da lista de aplicativos

Requisição cURL

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

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

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

Códigos de resposta HTTP

Código  Mensagem Observações/solução de problemas
200 OK Dados válidos retornados
200 OK

Sintoma: Nenhum dado é retornado

Ação: Verifique se o token de autenticação está no cabeçalho Bearer.

400 Pedido incorreto Consulte a mensagem contida no JSON
401 Não autorizado

Mensagem: O token de autorização está malformado

Certifique-se de que você tenha o token correto; ele deve ter mais de 700 caracteres.

404 Não encontrado
  • Resolva quaisquer problemas relacionados à network ou ao firewall. 
  • Certifique-se de que os endereços IP da AppsFlyer estejam na allowlist
  • Certifique-se de usar o token emitido mais recentemente.
  • Nenhum dado encontrado: nenhum aplicativo encontrado. 
429 Pedidos em excesso Limite de requisições excedido