Que sont les codes HTTP ?
Ce sont des codes de réponse standardisés à trois chiffres du protocole HTTP. Regroupés en cinq classes : 1xx (informatif), 2xx (succès), 3xx (redirection), 4xx (erreur client), 5xx (erreur serveur). Chaque code communique un résultat spécifique. Définis dans le RFC 7231.
Pourquoi ils sont importants
L'utilisation correcte est fondamentale pour les API fiables. Ils indiquent aux clients comment gérer les réponses : suivre les redirections, réessayer ou afficher des erreurs. Les moteurs de recherche utilisent 301 et 404. Les systèmes de surveillance détectent les 5xx. Un mauvais code peut casser le cache et nuire au SEO.
Codes courants
Les plus fréquents : 200 (OK), 201 (Créé), 204 (Pas de contenu), 301 (Déplacé définitivement), 302 (Trouvé), 304 (Non modifié), 400 (Mauvaise requête), 401 (Non authentifié), 403 (Interdit), 404 (Non trouvé), 429 (Trop de requêtes), 500 (Erreur interne), 502 (Mauvaise passerelle), 503 (Indisponible).
Bonnes pratiques
Retournez le code le plus spécifique. 201 après création. 204 pour DELETE sans corps. 400 pour validation. 429 avec Retry-After. Évitez 200 pour les erreurs. Journalisez les 5xx pour la surveillance.
