Resumo: Recupere os aplicativos ativos e pendentes associados à sua conta da AppsFlyer.
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 |
|
|
| 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
|
| offset |
O primeiro registro a ser retornado na chamada. Os números dos registros começam em 0.
|
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)
|
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 |
|
| 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.