De un vistazo: Las ad network pueden recuperar metadatos de las aplicaciones asociadas a su cuenta de partner integrada.
Obtener API de lista de apps
Las siguientes secciones incluyen la información necesaria para usar la API.
Conceptos básicos para obtener la lista de aplicaciones
| 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 JSON |
| Límite de solicitud |
|
|
| Límite de registros | 1.000 registros/solicitud. Si se van a devolver más de 1.000 registros, utiliza solicitudes de paginación posteriores, descritas en este artículo. |
Solicitud API
La solicitud de la API consta del método, la ruta, el parámetro obligatorio capabilities y los parámetros opcionales de paginación. El token se incluye en el encabezado de autorización.
Emitido
GET https://hq1.appsflyer.com/api/mng/apps?capabilities={capabilities}
Parámetros obligatorios para obtener la lista de aplicaciones
| Parámetro de consulta | Descripción | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Capacidades |
Para obtener la lista y el número de aplicaciones para las que tienes capacidades de permiso/integración, establece el parámetro capabilities en una de las opciones indicadas.
Ejemplo: Lista de aplicaciones para las que tienes permiso de API de reporte de Protect360: |
Mecanismo de paginación
Se ha implementado un mecanismo de paginación, siempre operativo.
Principios de 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. Representa el número de aplicaciones para las que se te han concedido las capacidades consultadas.
- Los enlaces de paginación (mostrados en el JSON siguiente) tienen las siguientes claves:
- links.prev: Si hubo una solicitud anterior: la solicitud usada para generar la página anterior.
- links.self: La solicitud actual: la solicitud usada para generar el JSON actual (página)
- links.next: La solicitud necesaria para obtener la página siguiente. Si no hay una clave next, esta es la última página.
Usa uno de los siguientes métodos de control de paginación:
- [Mejores prácticas] Usa los enlaces en el JSON: Si existe la clave links.next, úsala para crear una solicitud y obtener la página siguiente. Sigue haciéndolo hasta que recibas un JSON sin una clave links.next.
- 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 ejemplo siguiente contiene el resultado de la primera solicitud y consiste en la segunda solicitud, que contiene 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 página siguiente: los registros 5 y 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 del mecanismo de paginación (opcional)
| Parámetro de consulta | Descripción |
|---|---|
| limit |
Número de registros que se devuelven por llamada
|
| offset |
El primer registro que se devolverá en la llamada. La numeración de los registros empieza en 0.
|
Respuesta JSON
| Clave | Nota |
|---|---|
| ID | ID de la aplicación, por ejemplo: id123456789, com.myapp.com
|
| tipo | Devuelve siempre app |
| nombre | Nombre de aplicación |
| plataforma | iOS o Android |
| moneda | Código de divisa específico de la aplicación, tal como lo establece el anunciante |
| time_zone | Zona horaria específica de la aplicación, tal como la establece el anunciante |
| total_items | Número de aplicaciones para las que la ad network tiene la opción de capacidades solicitada |
| enlaces |
Mecanismo de paginación (explicado en la sección de parámetros)
|
Ejemplo de curl y respuesta para obtener la lista de aplicaciones
Solicitud de curl
Este ejemplo incluye una llamada completa, incluidos los parámetros opcionales de paginación.
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.}'
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.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"
}
}
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 |
|
| 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.