How can we help?

API de lista de apps para propietarios de apps

  • Actualización

En resumen: Recupera las aplicaciones activas y pendientes asociadas a tu cuenta de AppsFlyer.

mceclip0.png

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
  • 20 solicitudes/minuto
  • 100 solicitudes/día
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

  • Máximo: 1.000
  • Si no envías limit, se establece automáticamente en 1.000.
  • Ejemplo: limit=2
  • Obligatorio: No
offset

El primer registro que se devuelve en la llamada. Los números de registro empiezan en 0. 

  • Si no envías offset, se establece automáticamente en 0.
  • Ejemplo: offset=2
  • Obligatorio: No

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)

  • prev: la llamada utilizada para generar la página anterior
  • self: la llamada utilizada para generar la página actual
  • next: la llamada utilizada para generar la página siguiente

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.

Share article: