En resumen: Recupera las aplicaciones activas y pendientes asociadas a tu cuenta de AppsFlyer.
Si eres una ad network, usa la API de lista de apps para ad networks.
Más información: Lista de API para anunciantes
Obtener la API de lista de apps
Las siguientes secciones incluyen la información necesaria para usar la API.
Obtener los aspectos básicos de la lista de apps
Aspectos básicos de la lista de API
| Categoría | Elemento | Nota |
|---|---|---|
| Solicitud | Método HTTP | GET |
| Ruta | https://hq1.appsflyer.com/api/mng/apps | |
| Encabezado de autorización |
|
|
| Respuesta | Resultados | Devuelve en un JSON |
| Límite de solicitud |
|
|
| Límite de registros | 1.000 registros/solicitud. Si se van a devolver más de 1.000 registros, usa solicitudes de paginación de seguimiento descritas en este artículo. |
Solicitud API
La solicitud de la API consta del método, la ruta, el parámetro capabilities obligatorio y los parámetros de paginación opcionales. El token se incluye en el encabezado Authorization.
Emitido
GET https://hq1.appsflyer.com/api/mng/apps
Obtener los parámetros obligatorios de la lista de apps:
| Parámetro de consulta | Descripción |
|---|---|
| No hay parámetros de consulta obligatorios para esta API |
Mecanismo de paginación
Se ha implementado un mecanismo de paginación, siempre operativo.
Principios de la paginación:
- Devuelve hasta 1.000 registros por solicitud (página).
- Los JSON de respuesta contienen las siguientes claves relacionadas con la paginación:
- meta.total_items: El número de registros que devolverán todas las páginas en conjunto. Esto representa el número de aplicaciones para las que se te han concedido las capabilities que se están consultando.
- Los enlaces de paginación (mostrados en el JSON siguiente) tienen las siguientes claves:
- links.prev: Si hubo una solicitud anterior: la solicitud utilizada para generar la página anterior.
- links.self: La solicitud actual: la solicitud utilizada para generar el JSON (página) actual
- links.next: La solicitud necesaria para obtener la página siguiente. Si no hay ninguna clave next , esta es la última página.
Usa uno de los siguientes métodos de control de la paginación:
- [Mejores prácticas] Usa los enlaces en el JSON: si la clave links.next existe, úsala para crear una solicitud para obtener la página siguiente. Sigue haciéndolo hasta que recibas un JSON sin una links.next clave.
- Implementa mediante programación los parámetros limit y offset junto con la clave total_items.
Ejemplo de JSON de enlaces de paginación
- El siguiente ejemplo contiene el resultado de la segunda solicitud, que consta de dos registros en la sección de datos (no mostrada).
- El número total de registros que se devolverán es 6.
- La clave links.next contiene la solicitud que devuelve la segunda página: los registros 5 y 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 del mecanismo de paginación (opcionales):
| Parámetro de consulta | Descripción |
|---|---|
| límite |
Número de registros que se devuelven en cada llamada
|
| offset |
El primer registro que se devuelve en la llamada. Los números de registro empiezan en 0.
|
Respuesta JSON
| Clave | Nota |
|---|---|
| ID | ID de la aplicación, por ejemplo: id123456789, com.myapp.com
|
| type | Devuelve siempre app |
| conjunto de anuncios | Nombre de aplicación |
| Identificador de origen | iOS o Android |
| moneda | Código de moneda específico de la aplicación |
| time_zone | Zona horaria específica de la aplicación |
| total_items | Cantidad de aplicaciones alojadas en la cuenta |
| enlaces |
Mecanismo de paginación (explicado en la sección de parámetros)
|
Ejemplo de cURL para obtener la lista de aplicaciones y respuesta
Solicitud cURL
Este ejemplo incluye una llamada completa, incluidos los parámetros de paginación opcionales.
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.}' \
Respuesta 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 respuesta HTTP
| Código | Mensaje | Observaciones/resolución de problemas |
|---|---|---|
| 200 | Correcto | Datos válidos devueltos |
| 200 | Correcto |
Síntoma: No se devuelven datos Acción: Asegúrate de que el token de autenticación esté en el encabezado Bearer. |
| 400 | Solicitud incorrecta | Consulta el mensaje incluido en el JSON |
| 401 | No autorizado |
Mensaje: El token de autorización tiene un formato incorrecto Asegúrate de que tienes el token correcto; el token debe tener más de 700 caracteres. |
| 404 | No encontrado |
|
| 429 | Demasiadas solicitudes | Se ha superado el límite de solicitudes |
This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.