Erreurs
L’API REST utilise les codes d’état HTTP standard et retourne un corps d’erreur JSON :
{ "error": "unauthorized", "message": "Missing or invalid API key" }
# Codes d’état
| Statut | error |
Quand |
|---|---|---|
400 |
invalid-argument |
Corps malformé ou champ requis manquant. |
401 |
unauthorized |
Clé API manquante, invalide ou révoquée. |
403 |
forbidden / failed-precondition |
Au-delà des droits de votre plan (par ex. frappe de codes sérialisés sans Enterprise, ou dépassement d’un quota). La limite est dans le message. |
404 |
not-found |
Aucun lien/campagne/travail avec cet id, ou non détenu par votre compte. |
429 |
rate-limited |
Limite de débit par clé dépassée — attendez et réessayez. |
5xx |
internal |
Quelque chose a mal tourné de notre côté ; sûr de réessayer les lectures idempotentes. |
# Propriété
Chaque lecture et écriture est limitée au compte que la clé API résout. Demander le lien ou la campagne d’un autre compte retourne 404 (pas 403) — nous ne révélons pas qu’il existe.
# Travaux asynchrones
Les travaux par lot et frappe sérialisée acceptent la demande
(200, queued), puis exposent les défaillances dans le statut du travail (status: "failed" avec une raison), pas dans la réponse HTTP d’origine. Interrogez toujours le travail.
# Vérification
Les points d’extrémité publics de vérification ne font jamais erreur sur un numéro de série inconnu —
ils retournent status: "unknown" (un code faux/non émis est une réponse significative, pas un 404).
# Suivant
- Authentification · la référence API complète.