Compartir a través de

Restricciones de uso de API

  • Artículo

Limitación de entrada y salida

Para garantizar un buen rendimiento, todas las cuentas están limitadas a 100 lecturas por minuto y 60 escrituras por minuto. La API aplica este límite mediante programación en un nivel de miembro. Esto significa que si hay dos usuarios de API para un solo miembro, compartirán el límite de limitación (es decir, dos usuarios pueden hacer un promedio de 50 lecturas por minuto cada uno, cuatro usuarios pueden hacer un promedio de 25 lecturas por minuto cada uno). Si necesita más lecturas o escrituras por minuto, póngase en contacto con su representante de la cuenta de Xandr.

Cada respuesta incluye un "dbg_info" objeto que transmite información sobre la llamada api y la respuesta que es solo para uso interno de Xandr y que se puede solicitar durante una consulta de soporte técnico.

Paginación

El número máximo de objetos que se pueden devolver en una respuesta GET determinada es 100. Para recuperar más de 100 objetos, puede paginar los resultados especificando start_element y num_elements en la cadena de consulta de la solicitud GET. Por ejemplo, la siguiente solicitud devolvería los primeros 50 objetos de la respuesta:

$ curl -b cookies -c cookies 'https://api.adnxs.net/creative?start_element=0&num_elements=50'

Para recuperar los 50 siguientes, simplemente establecería start_element=50.

  • El primer elemento es el elemento 0.
  • Todas las respuestas GET tendrán una propiedad "count" que muestra el número total de elementos que coinciden con la solicitud GET.
  • Esto también se aplicará a los servicios que no son de informes, como el servicio de búsqueda creativa, que se solicitan con métodos distintos de los GET.

Ejemplos

$ curl -b cookies -c cookies 'https://api.adnxs.net/segment/1?start_element=0&num_elements=100'
$ curl -b cookies -c cookies 'https://api.adnxs.net/creative/1?start_element=0&num_elements=100'

Frecuencia de autenticación

Después de autenticarse, el token permanece válido durante 2 horas. No es necesario volver a autenticarse en este momento. Si vuelve a autenticarse, tenga en cuenta que la API le permite autenticarse correctamente 10 veces por período de 5 minutos. Los intentos de autenticación posteriores en esos 5 minutos producirán un error.

Sugerencia

Se recomienda buscar la error_id "NOAUTH" en las respuestas de llamada y volver a autenticarse solo después de recibirla.

Límites de objetos

Xandr limita el número de creatividades no expiradas que puede tener en la plataforma. Además, Xandr limita el número de dominios que se pueden usar en una sola lista de dominios y el número de destinos determinados que se pueden usar en un único perfil. Para todos los tipos de objeto excepto las creatividades, los objetos activos e inactivos se cuentan con respecto al límite. En el caso de las creatividades, solo los objetos no expirados se cuentan con respecto al límite. Una creatividad expira cuando no se ha servido ni se ha modificado en 45 días.

Sugerencia

Puede usar el servicio de límite de objetos para ver los límites y supervisar de forma proactiva el uso. Además, para ver las preguntas más frecuentes sobre los límites de objetos, consulte Límites de objetos - Preguntas más frecuentes.