Codes d'Erreurs
CiteAPI utilise les codes de statut HTTP standards pour indiquer le succès ou l'échec des requêtes.
Codes de statut HTTP
| Code | Nom | Description | Solution |
|---|---|---|---|
| 400 | Bad Request | Requête malformée ou paramètres invalides | Vérifiez votre structure JSON et les valeurs des paramètres |
| 401 | Unauthorized | Clé API manquante ou invalide | Vérifiez que votre token Bearer est correctement formaté |
| 403 | Forbidden | Votre forfait ne permet pas l'accès à cette ressource | Vérifiez les scopes de votre plan (PRO vs EXPERT) |
| 404 | Not Found | Ressource inexistante | Vérifiez l'ID du projet, de l'audit ou le chemin de l'endpoint |
| 429 | Too Many Requests | Limite de débit dépassée | Réduisez la fréquence de vos requêtes |
| 500 | Internal Error | Erreur serveur inattendue | L'équipe technique est notifiée automatiquement |
Format des réponses d'erreur
Toutes les erreurs retournent un objet JSON avec un champ error contenant un message descriptif :
{
"error": "Forbidden: API access requires a PRO or EXPERT plan"
}
Débogage rapide
Le message d'erreur est toujours en anglais et conçu pour être actionnable — il indique précisément ce qui doit être corrigé.