Référence des codes d'erreur
Comprendre les codes de statut HTTP et les gérer
2xx Succès
La requête a réussi et la réponse contient les données demandées.
Fréquent avec : GET, POST, PUT
Une nouvelle ressource a été créée avec succès.
Fréquent avec : POST de création
4xx Erreurs client
Requête mal formée ou paramètres invalides.
Causes fréquentes : champs obligatoires manquants, JSON invalide, types incorrects
Authentification requise ou échouée. Clé API manquante ou invalide.
Causes fréquentes : absence de clé, clé invalide ou expirée
Vous n'avez pas la permission d'accéder à cette ressource.
Causes fréquentes : permissions insuffisantes, compte suspendu, endpoint test avec clé production
La ressource n'existe pas. Vérifiez l'URL du point de terminaison.
Causes fréquentes : URL erronée, faute de frappe, ressource supprimée
Requête syntaxiquement correcte mais erreurs sémantiques ou de validation.
Causes fréquentes : format e-mail invalide, valeurs hors bornes, règles métier
Limite de débit dépassée. Attendez ou changez de formule.
Causes fréquentes : trop de requêtes par minute, quota journalier dépassé
5xx Erreurs serveur
Erreur inattendue côté serveur. Problème temporaire.
Action : réessayez. Si le problème persiste, contactez le support.
La passerelle a reçu une réponse invalide du serveur backend.
Action : réessayez après une courte pause.
Service temporairement indisponible (maintenance ou surcharge).
Action : consultez la page de statut et réessayez plus tard.
La passerelle n'a pas reçu de réponse du backend à temps.
Action : réessayez avec backoff exponentiel.
Bonnes pratiques de gestion des erreurs
- ✓ Vérifiez toujours le code de statut avant de traiter le corps de la réponse
- ✓ Implémentez un backoff exponentiel pour les erreurs 5xx
- ✓ Journalisez les détails sans exposer de données sensibles
- ✓ Respectez les en-têtes retry-after en cas de limitation de débit
- ✓ Affichez des messages clairs plutôt que la réponse brute de l'API
Besoin d'aide pour le dépannage ?