Aller au contenu principal

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​

CodeNomDescriptionSolution
400Bad RequestRequê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
401UnauthorizedClé API manquante, invalide, expirée, révoquée, ou dont le créateur n'a plus les droits de la créerVérifiez le token Bearer, sinon créez une nouvelle clé
403ForbiddenForfait 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 forfaitVérifiez le forfait et recréez une clé avec écriture si besoin
404Not FoundRessource inexistanteVérifiez l'ID de la marque, de l'audit, du thème ou le chemin de l'endpoint
409ConflictLa création de prompts ne peut pas aboutir pour l'instantRéessayez plus tard
429Too Many Requestscode: "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
500Internal ErrorErreur serveur inattendue. Au lancement d'un audit, code: "unavailable" : le quota n'a pas pu être luRé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é.