How can we help?

API de lista de aplicaciones para ad network

  • Actualización

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
  • 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, 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. 

Opción Tipo de valor esperado Nota
protect_360 Permiso de reporte Obtén Reportes de raw data de Protect360 para ad networks
cost  Integración La aplicación está habilitada para obtener datos de costo a través de la API de InCost

Ejemplo: Lista de aplicaciones para las que tienes permiso de API de reporte de Protect360:capabilities=protect_360

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

  • 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 devolverá en la llamada. La numeración de los registros empieza 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
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)

  • 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 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
  • Consulta el mensaje incluido en el JSON
  • JSON vacío: se ha especificado una capacidad no válida
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
  • Resuelve cualquier problema relacionado con la red o el cortafuegos. 
  • Asegúrate de que las direcciones IP de AppsFlyer estén en la lista de permitidos
  • Asegúrate de que usas el token emitido más recientemente.
  • No se han encontrado datos: el tipo de permiso/integración (capacidades) solicitado es legal, pero no se ha encontrado ninguna app con permiso. 
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: