Contraintes d’utilisation de l’API

Limitation d’entrée et de sortie

Pour garantir de bonnes performances, tous les comptes sont limités à 100 lectures par minute et à 60 écritures par minute. Cette limite est appliquée par programme par l’API au niveau d’un membre. Cela signifie que s’il existe deux utilisateurs d’API pour un seul membre, ils partageront la limite de limitation (autrement dit, deux utilisateurs peuvent en moyenne 50 lectures par minute chacun, quatre utilisateurs peuvent en moyenne 25 lectures par minute chacun). Si vous avez besoin de davantage de lectures ou d’écritures par minute, contactez votre représentant de compte Xandr.

Chaque réponse inclut un "dbg_info" objet qui transmet des informations sur l’appel et la réponse d’API destinés à un usage interne Xandr uniquement et pouvant être demandés lors d’une demande de support.

Pagination

Le nombre maximal d’objets pouvant être retournés dans une réponse GET donnée est de 100. Pour récupérer plus de 100 objets, vous pouvez paginer les résultats en spécifiant start_element et num_elements dans la chaîne de requête de la requête GET. Par exemple, la requête suivante retourne les 50 premiers objets dans la réponse :

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

Pour récupérer les 50 suivants, vous devez simplement définir start_element=50.

Le premier élément est l’élément 0.
Toutes les réponses GET auront une propriété « count » indiquant le nombre total d’éléments correspondant à cette requête GET.
Cela s’applique également aux services qui ne sont pas des services de création de rapports, tels que le service de recherche créative, qui sont demandés avec des méthodes autres que les GET.

Exemples

$ 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'

Fréquence d’authentification

Après l’authentification, votre jeton reste valide pendant 2 heures. Vous n’avez pas besoin de vous authentifier à nouveau dans ce délai. Si vous vous authentifiez à nouveau, notez que l’API vous permet de vous authentifier correctement 10 fois par période de 5 minutes. Toutes les tentatives d’authentification suivantes dans ces 5 minutes entraînent une erreur.

Conseil

Il est recommandé de rechercher le error_id « NOAUTH » dans vos réponses à l’appel et de vous authentifier à nouveau uniquement après l’avoir reçu.

Limites des objets

Xandr limite le nombre de créations non expirées que vous pouvez avoir sur la plateforme. En outre, Xandr limite le nombre de domaines pouvant être utilisés dans une liste de domaines unique et le nombre de cibles qui peuvent être utilisées dans un seul profil. Pour tous les types d’objets à l’exception des objets créatifs, les objets actifs et inactifs sont comptabilisés par rapport à la limite. Pour les créations, seuls les objets non expirés sont comptabilisés par rapport à la limite. Un élément créatif expire lorsqu’il n’a pas été ni servi ni modifié dans 45 jours.