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. Au lancement d'un audit, code: "prompts_required" (aucun prompt actif) ou code: "project_not_ready" (onboarding non terminé) | Vérifiez votre structure JSON et les valeurs des paramètres, créez des prompts avant l'audit |
| 401 | Unauthorized | Clé API manquante, invalide, expirée, révoquée, ou dont le créateur n'a plus les droits de la créer | Vérifiez le token Bearer, sinon créez une nouvelle clé |
| 403 | Forbidden | Forfait sans accès API (Free, feature: "apiAccess", voir Forfaits), clé sans le scope write sur un POST, ou clé limitée à une autre marque. Au lancement d'un audit, code: "plan_required" : audit manuel ou moteur hors forfait | Vérifiez le forfait et recréez une clé avec écriture si besoin |
| 404 | Not Found | Ressource inexistante | Vérifiez l'ID de la marque, de l'audit, du thème ou le chemin de l'endpoint |
| 409 | Conflict | La création de prompts ne peut pas aboutir pour l'instant | Réessayez plus tard |
| 429 | Too Many Requests | code: "quota_exceeded" : audits manuels de la semaine épuisés, ou moins d'audits restants que de moteurs demandés. Sans code : plus de 10 lancements d'audit en une minute avec la même clé | Attendez la durée de l'en-tête Retry-After, en secondes, ou demandez moins de moteurs |
| 500 | Internal Error | Erreur serveur inattendue. Au lancement d'un audit, code: "unavailable" : le quota n'a pas pu être lu | Réessayez. 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. Les refus du lancement d'un audit ajoutent un code stable, à tester plutôt que le message :
{
"error": "Forbidden: This API key does not have write permissions"
}
{
"error": "This brand has used its 5 manual audits for this week, so no audit started.",
"code": "quota_exceeded"
}
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é.