HTTP Status Codes
Understand HTTP Status Codes
Une référence consultable de tous les codes de statut HTTP standard, de 100 Continue à 511 Network Authentication Required, avec ce que chacun signifie réellement.
How it works
Les codes de statut HTTP sont regroupés par leur premier chiffre : 1xx est informationnel, 2xx a réussi, 3xx redirige, 4xx incrimine la requête, 5xx incrimine le serveur. Ce chiffre est le contrat — un client qui ne reconnaît pas 429 doit malgré tout le traiter comme un 4xx générique et ne pas réessayer aveuglément. Ce sont les distinctions à l'intérieur d'une classe qui portent le vrai sens : 301 et 308 sont tous deux permanents, mais seul 308 interdit au client de réécrire la méthode en GET lors de la redirection, et c'est pourquoi un point d'accès POST déplacé définitivement exige un 308. Cette page est une table de correspondance locale ; elle n'envoie aucune requête.
When to use it
- Décider quel code un point d'accès d'API doit renvoyer en cas d'échec de validation (422 pour un corps bien formé mais sémantiquement faux, 400 pour une entrée malformée)
- Lire un journal de CDN ou de répartiteur de charge et séparer les défaillances de l'origine (502, 504) des erreurs signalées par l'origine (500)
- Choisir entre 301, 302, 307 et 308 pour une migration d'URL sans casser les requêtes POST ni le référencement
- Expliquer à un collègue pourquoi une requête qui « semble connectée » renvoie 403 et non 401
Watch out for
- 401 signifie « non authentifié » et 403 « authentifié mais non autorisé » — les noms sont à l'envers de l'intuition, puisque le code appelé Unauthorized est celui qui réclame des identifiants.
- Une réponse 200 peut malgré tout contenir une erreur. Beaucoup d'API renvoient {"error": ...} avec un statut 200 : le statut seul n'est donc pas un contrôle de réussite — inspectez le corps.
- 418 I'm a Teapot vient de la RFC 2324, un poisson d'avril de 1998. Il est assez réel pour que des serveurs l'implémentent, mais il ne fait pas partie de la norme HTTP.
- Des codes au-delà de 511 ou hors de l'ensemble enregistré sont légaux sur le réseau — mandataires et WAF inventent les leurs (la plage 5xx de Cloudflare, par exemple). Un code que vous ne trouvez pas ici est probablement propre à un fournisseur.
Frequently Asked Questions
Quelle est la différence entre 401 et 403 ?
401 Unauthorized signifie que le client n'est pas authentifié — il faut se connecter ou fournir un identifiant valide. 403 Forbidden signifie que le serveur sait qui vous êtes mais que vous n'avez pas la permission d'accéder à cette ressource. 401 réclame des identifiants ; 403 les refuse.
Quand utiliser une redirection 301 plutôt qu'une 302 ?
301 (Moved Permanently) demande aux navigateurs et aux moteurs de recherche de mettre définitivement à jour les liens en cache — à utiliser pour un changement d'URL sans risque pour le référencement. 302 (Found / Temporary Redirect) indique que l'URL d'origine reste valide — à utiliser pour les tests A/B, les pages de maintenance ou les redirections éphémères.
Qu'est-ce qui provoque une erreur 502 Bad Gateway ?
502 signifie qu'un serveur jouant le rôle de mandataire (nginx, CDN, répartiteur de charge) a reçu une réponse invalide d'un serveur en amont. Causes fréquentes : le serveur d'origine est arrêté, a dépassé son délai d'attente ou a renvoyé du HTTP malformé. Commencez par consulter les journaux de santé de l'origine.
How to Use HTTP Status Codes
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.