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 invalidesVérifiez votre structure JSON et les valeurs des paramètres
401UnauthorizedClé API manquante ou invalideVérifiez que votre token Bearer est correctement formaté
403ForbiddenForfait sans accès API (il faut Pro ou Expert), ou clé sans le scope write sur un POSTVérifiez le forfait et recréez une clé avec écriture si besoin
404Not FoundRessource inexistanteVérifiez l'ID du projet, de l'audit ou le chemin de l'endpoint
500Internal ErrorErreur serveur inattendueL'é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: This API key does not have write permissions"
}

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é.