Docs

Erreurs et limites de débit

Format des erreurs AdLib, codes d’erreur, limites de requêtes par minute selon l’offre, en-têtes de limite de débit et comment réessayer.

Format des erreurs

Les erreurs renvoient un corps JSON avec un code lisible par une machine :

JSON
{
  "error": {
    "code": "not_found",
    "message": "ad meta:123 not found",
    "request_id": "c821fd4d-699b-4080-9776-841f4b57aad2",
    "billed": false
  }
}

Les erreurs ne sont jamais facturées. Indiquez le request_id (aussi présent dans l’en-tête X-Request-Id) quand vous nous contactez.

Codes

Code Signification Que faire
bad_request Un paramètre manque ou est invalide ; details précise lequel Corrigez la requête
invalid_cursor Le cursor ne vient pas d’un next_cursor Renvoyez next_cursor tel quel
invalid_webhook_url L’URL du webhook n’est pas une adresse http(s) publique (localhost, hôtes privés, link-local et internes sont refusés) Utilisez une URL accessible depuis Internet
interval_too_short interval_hours est inférieur à ce que votre compte autorise (24 avec les crédits gratuits, 6 après l’achat d’un pack) Augmentez interval_hours ou achetez un pack
watchlist_too_large Les listes de suivi dépasseraient le nombre de marques autorisé pour votre compte (3 avec les crédits gratuits, 250 après un pack) Retirez des marques ou achetez un pack
batch_too_large Plus d’éléments dans un lot que votre compte n’en autorise (10 avec les crédits gratuits, 100 après un pack) Découpez le lot
unauthorized Clé API absente ou invalide Vérifiez l’en-tête X-API-Key
account_blocked Le compte est bloqué Contactez-nous
history_limit La publicité est plus ancienne que l’archive de votre compte (12 mois avec les crédits gratuits) Achetez un pack pour l’archive complète
not_found La publicité, l’annonceur, le job ou l’endpoint n’existe pas Vérifiez l’identifiant ou le chemin
rate_limited Vous dépassez les requêtes par minute de votre compte (30 avec les crédits gratuits, 300 après un pack) Attendez Retry-After secondes
quota_exceeded Crédits gratuits et packs épuisés Achetez un pack ; ne réessayez pas
upstream_error La bibliothèque de la plateforme a échoué ou bloqué la requête Réessayez plus tard ; consultez le statut
internal_error Erreur de notre côté Réessayez ; prévenez-nous si cela persiste

Limites de débit

Compte Requêtes par minute
Avec les crédits gratuits 30
Après le premier pack de crédits 300

Chaque réponse contient X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset (secondes avant la réinitialisation de la fenêtre). Au-delà de la limite, l’API répond 429 rate_limited avec un en-tête Retry-After.

Nouvelles tentatives

Réessayez rate_limited, upstream_error et internal_error avec un backoff. Ne réessayez pas bad_request, unauthorized, not_found ni quota_exceeded. Les plateformes modifient parfois leurs bibliothèques sans prévenir ; quand l’une d’elles casse, ses appels échouent vite, ne sont pas facturés et apparaissent sur la page de statut.