Ce que signifient les codes de statut HTTP

Chaque fois que votre navigateur charge une page ou qu'une appli appelle une API, le serveur répond avec un code de statut à trois chiffres. La plupart du temps vous ne le voyez jamais, mais quand quelque chose casse — un 404, un 500 — ce nombre est le premier indice. Ce guide vous apprend à lire les codes de statut d'un coup d'œil.

Lisez le premier chiffre

L'astuce, c'est que le premier chiffre vous donne la catégorie, ce qui vous permet de comprendre l'intention d'un code jamais vu :

• 1xx — Informational : reçu, encore en traitement (rare au quotidien).
• 2xx — Success : ça a marché.
• 3xx — Redirection : la ressource est ailleurs.
• 4xx — Client error : la requête était fausse (votre côté).
• 5xx — Server error : la requête était correcte, le serveur a échoué.

Cette séparation 4xx contre 5xx est la distinction la plus utile au débogage : 4xx signifie corrigez la requête ; 5xx signifie que le serveur est en cause.

Les codes que vous rencontrerez vraiment

Succès et redirections

• 200 OK — la réponse standard « ça a marché ».
• 201 Created — une nouvelle ressource a été créée (après un POST).
• 301 Moved Permanently — cette URL a définitivement changé ; mettez à jour vos liens. Important pour le SEO.
• 302 Found — une redirection temporaire ; continuez d'utiliser l'URL d'origine.
• 304 Not Modified — votre copie en cache est encore valide, donc rien n'a été renvoyé.

Erreurs client (4xx)

• 400 Bad Request — la requête était mal formée.
• 401 Unauthorized — vous devez vous authentifier (vous connecter).
• 403 Forbidden — vous êtes authentifié mais non autorisé.
• 404 Not Found — la ressource n'existe pas.
• 429 Too Many Requests — vous êtes limité en débit ; ralentissez.

Erreurs serveur (5xx)

• 500 Internal Server Error — une défaillance générique côté serveur.
• 502 Bad Gateway — un serveur en amont a renvoyé une mauvaise réponse.
• 503 Service Unavailable — le serveur est surchargé ou hors service pour maintenance.
• 504 Gateway Timeout — un serveur en amont n'a pas répondu à temps.

401 vs. 403 : une confusion courante

Ces deux-là se ressemblent mais diffèrent d'un mot. 401 Unauthorized signifie en réalité « non authentifié » — le serveur ne sait pas qui vous êtes, alors connectez-vous. 403 Forbidden signifie que le serveur sait qui vous êtes et que vous n'êtes toujours pas autorisé. L'un porte sur l'identité, l'autre sur la permission.

La liste complète

Pour chaque code enregistré avec sa signification — consultable et groupé par classe — voyez notre référence complète des codes de statut HTTP. Si vous déboguez des réponses d'API, nos guides sur les JWT et l'encodage d'URL couvrent deux autres choses que vous croiserez constamment.