Erreurs
Erreurs
L'API GEOCitation utilise les codes de statut HTTP standards.
| Code | Signification | Que faire |
|---|---|---|
202 | Accepté | Audit en file d'attente. Attendez le webhook ou interrogez /v1/audits/{id}/status. |
400 | Requête invalide | Vérifiez le corps de la requête — ex. URL non autorisée. |
401 | Non autorisé | Votre X-API-Key est manquante, invalide ou révoquée. |
402 | Paiement requis | Quota épuisé ou aucun plan actif. Passez à un plan supérieur. |
404 | Non trouvé | L'audit_id n'existe pas ou n'appartient pas à votre compte. |
409 | Conflit | L'audit n'est pas dans un état permettant cette opération (ex. retry sur un audit déjà terminé). |
422 | Entité non traitable | Erreur de validation. Vérifiez audit_type, mot clé, pays. |
429 | Trop de requêtes | Limite de débit atteinte. Réessayez après Retry-After. |
500 | Erreur serveur | Erreur serveur inattendue. Réessayez avec backoff exponentiel. |
502 | Passerelle invalide | Résultat temporairement malformé. Réessayez la requête. |
503 | Service indisponible | Service temporairement indisponible. Réessayez avec backoff. |
Limitation de Débit
L'API autorise 100 requêtes par minute globalement et 20 audits par heure et par clé. Dépasser ces limites retourne un 429.
Format des Erreurs
La plupart des erreurs retournent un simple message dans le champ detail. Les erreurs de quota (402) retournent un objet detail structuré avec un contexte additionnel.
json
// Most errors — plain detail message
{
"detail": "Invalid or revoked API key"
}
// Quota errors — structured detail
{
"detail": {
"error": "quota_exceeded",
"used": 100,
"limit": 100,
"plan": "starter"
}
}