How can we help?

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

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: