Codes de statut HTTP

Qu’est-ce qu’une référence des codes de statut HTTP ?#

Chaque réponse HTTP transporte un code de statut à trois chiffres qui indique au client, en un seul nombre, ce qui s’est passé de sa requête. Les chiffres ne sont pas aléatoires : le premier nomme une famille — 1xx signifie « attendez, j’envoie des informations », 2xx signifie « voilà, ça a marché », 3xx signifie « allez voir ailleurs », 4xx signifie « vous, le client, vous vous êtes trompé » et 5xx signifie « moi, le serveur, je me suis trompé ». Mémorisez ces cinq familles et vous lisez n’importe quel échange HTTP d’un coup d’œil, qu’il s’agisse d’une requête navigateur, d’un curl que vous avez lancé ou d’une erreur dans vos logs applicatifs.

Le problème, c’est qu’il y a plus de soixante codes en usage réel, et que les différences entre voisins sont souvent subtiles : 401 contre 403, 302 contre 307, 422 contre 400. Cette page est une référence consultable pour tous — le code, sa phrase de raison IANA, sa famille et une explication en clair. Saisissez un nombre ou un mot et le tableau se réduit instantanément.

Comment l’utiliser#

1. Parcourez ou recherchez. Le tableau liste tous les codes regroupés par famille (1xx à 5xx). Utilisez la zone de recherche en haut pour filtrer.
2. Recherchez comme vous pensez. Le filtre est intelligent sur l’intention :
   • Saisissez un nombre comme 30 ou 418 et il fait correspondre les codes par préfixe — 30 fait surgir toute la famille de redirection 3xx.
   • Saisissez un mot comme redirect, timeout ou teapot et il cherche dans la phrase de raison et la description, sans tenir compte de la casse.
3. Lisez la ligne. Chaque ligne affiche Code (le nombre), Raison (la phrase standard telle que « Not Found »), Catégorie (le libellé localisé de la famille) et Description (une courte explication du moment où ce code est renvoyé). La barre d’état sous le tableau indique combien de lignes correspondent.

Caractéristiques principales#

• Le jeu IANA complet, plus les codes de facto. Couvre tous les codes que le web renvoie réellement, de 100 Continue à 511 Network Authentication Required, y compris les entrées WebDAV 207/208/226, la blague 418 I'm a Teapot et le 451 imposé par la loi.
• Recherche par nombre consciente des préfixes. Saisir 4 ne déverse pas un sous-ensemble aléatoire — cela vous donne every erreur client 4xx dans l’ordre, ce qui est exactement comment on explore une famille qu’on ne connaît plus.
• Recherche par mot dans la raison et la description. « rate » trouve 429 Too Many Requests ; « range » trouve 416 Range Not Satisfiable ; « auth » fait surgir à la fois 401 et 407.
• Les phrases de raison sont universelles. Les phrases (« Not Found », « Gateway Timeout ») sont des identifiants techniques, pas des traductions — elles correspondent à ce que les serveurs envoient réellement sur le fil, donc vous pouvez les coller telles quelles dans une documentation ou un suivi de ticket.
• S’exécute entièrement dans votre navigateur. Le jeu de données est livré avec la page ; le filtrage se fait localement sans requête réseau.

Exemple commenté#

Trois codes qui font trébucher presque tout développeur au moins une fois forment le trio d’erreurs client 401, 403 et 404. Cherchez les chiffres 40 et vous les obtenez tous les trois d’un coup, côte à côte :

• 401 Unauthorized — « Une authentification est requise et a échoué ou n’a pas été fournie. » Le serveur ne sait pas qui vous êtes. Solution : envoyer des identifiants (un jeton de connexion, une clé d’API).
• 403 Forbidden — « La requête était valide mais le serveur refuse d’agir (droits insuffisants). » Le serveur sait exactement qui vous êtes, et vous ne pouvez quand même pas l’obtenir. Solution : obtenir l’autorisation, pas un autre mot de passe.
• 404 Not Found — « La ressource demandée est introuvable. » L’URL elle-même est mauvaise ou la ressource a disparu. Solution : corriger le chemin.

La distinction la plus utile est 401 contre 403 : « je ne vous connais pas » (connectez-vous) contre « je vous connais, et non » (demandez l’accès). Se ré-authentifier ne corrigera jamais un 403, et bidouiller l’URL ne corrigera jamais un 401.

Une seconde recherche pratique est la famille des redirections. Cherchez 30 et vous voyez que 301 et 302 permettaient historiquement aux clients de changer de méthode à la requête suivante (un POST pouvait dégénérer en GET), alors que 307 et 308 ont été introduits précisément pour préserver la méthode d’origine — c’est pourquoi les API modernes qui redirigent des soumissions de formulaire vous pointent vers 307/308 au lieu de 301/302.

FAQ#

Que signifie le premier chiffre d’un code de statut ?#

Il nomme la famille. 1xx est informationnel (le serveur dit « attendez, plus arrive »), 2xx est le succès, 3xx est la redirection (allez voir ailleurs), 4xx est une erreur client (votre requête était mauvaise) et 5xx est une erreur serveur (la requête était correcte mais le serveur a échoué). Les deux chiffres restants identifient le code précis au sein de cette famille.

418 est-il un vrai code de statut ?#

Il vient d’une RFC du premier avril sur une théière qui refuse de préparer du café, donc il n’est pas fait pour la production. Cela dit, certains services renvoient genuinely 418 comme réponse ludique « vous m’avez envoyé quelque chose d’absurde », et il est inoffensif à reconnaître. Cette référence le liste parce que vous le croiserez dans la nature.

Pourquoi certains codes sont-ils marqués WebDAV ?#

Des codes comme 207 Multi-Status, 423 Locked et 507 Insufficient Storage ont été définis pour WebDAV, une extension d’HTTP pour l’édition collaborative de fichiers. Ils sont rares sur les API web ordinaires mais apparaissent dans les systèmes qui exposent une interface de type système de fichiers, donc les descriptions notent l’origine WebDAV pour que le contexte ait du sens.

D’où viennent les phrases de raison ?#

Ce sont les phrases de raison anglaises standard enregistrées auprès de l’IANA — les mêmes chaînes que les serveurs placent après le code sur la ligne de statut (par exemple HTTP/1.1 404 Not Found). Ce sont des identifiants techniques, donc ils sont affichés tels quels plutôt que traduits ; la partie localisée de la page, ce sont les en-têtes de colonnes, les libellés de catégorie et ce texte explicatif.