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 :
{
"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.