Aller au contenu
helpyself

Codes HTTP

Local uniquement — rien n'est envoyé sauf si vous l'enregistrez ou le partagez.

Tous les codes de statut HTTP, ce qu'ils signifient et quand les envoyer — avec la RFC qui les définit.

  1. Tapez le code, par exemple 404, ou un mot comme « redirection » dans le champ de recherche.
  2. Lisez ce que signifie le code, quand l'envoyer et quelle RFC le définit.
  3. Choisissez une classe comme 4xx, ou videz le champ pour voir tous les codes regroupés par classe.

4xx · Erreur du client

404

Not Found

Le serveur n'a rien à cette adresse, ou ne veut pas dire s'il a quelque chose.

Quand l'utiliser: La réponse à un lien cassé ou à une URL mal tapée. Également utilisé à la place de 403 pour cacher qu'une ressource privée existe. Si elle a disparu pour de bon, 410 le dit.

Défini dans RFC 9110 §15.5.5

Enregistrer cet outil

Gardez Codes HTTP sous la main

Ajouter aux favoris
Intégrer

Ajoutez Codes HTTP à votre site

Collez ce code dans votre page. Il affiche l’outil, gratuitement, avec un lien vers lui.

Aperçu

À propos de cet outil

Tous les codes de statut HTTP du registre officiel de l'IANA, de 100 Continue à 511 Network Authentication Required, chacun avec une explication claire de ce qu'il signifie, du moment où un serveur doit l'envoyer, et un lien vers la section de la RFC qui le définit. Tapez un numéro, le premier chiffre d'une classe (« 4 » ou « 4xx ») ou un mot comme « redirection » ou « limite », et la liste se réduit au fil de la saisie. Les différences qui comptent sont expliquées au lieu d'être laissées au seul nom. 401 Unauthorized signifie que la requête n'était pas authentifiée — connectez-vous et réessayez — tandis que 403 Forbidden signifie que le serveur a compris la requête et refuse quand même. 301 et 302 permettent à un ancien client de transformer un POST en GET en suivant la nouvelle adresse ; 308 et 307 sont les deux mêmes redirections, avec la garantie que la méthode est conservée. 422 Unprocessable Content n'est plus un ajout de WebDAV : la RFC 9110 l'a intégré à HTTP en 2022, c'est pourquoi c'est la réponse habituelle à une erreur de validation. Les noms restent exactement tels que la spécification les écrit, car c'est ce qui figure sur la ligne de statut, dans vos journaux et dans toutes les bibliothèques. Quand un code a été renommé — 413 s'appelait Payload Too Large, 422 Unprocessable Entity — l'ancien nom est affiché aussi, et la recherche le trouve. 418 I'm a teapot est là également, présenté pour ce qu'il est : une blague de poisson d'avril de la RFC 2324, que la RFC 9110 réserve désormais pour que personne ne donne un vrai rôle à ce numéro. Les codes non officiels, comme le 499 de nginx ou les 520 à 526 de Cloudflare, ne figurent pas dans le registre et ne sont pas présentés comme s'ils y étaient. Tout fonctionne dans votre navigateur, et hors ligne une fois la page chargée.

Questions fréquentes

Quelle est la différence entre 401 et 403 ?

401 Unauthorized signifie que la requête n'a pas d'identifiants valides : le serveur ne sait pas qui vous êtes, et il doit indiquer comment s'authentifier dans un en-tête WWW-Authenticate. Se connecter peut régler le problème. 403 Forbidden signifie que le serveur a compris la requête et la refuse malgré tout : la répéter avec les mêmes identifiants n'y changera rien, seul un compte disposant du bon droit le pourrait. Malgré son nom, 401 concerne l'authentification et 403 l'autorisation.

Faut-il utiliser 301 ou 308 pour une redirection permanente ?

Pour une page web, les deux conviennent, et 301 est celui que tous les robots et navigateurs gèrent depuis des décennies ; les moteurs de recherche les traitent de la même façon. La différence tient à la méthode. Avec 301, un ancien client a le droit de transformer un POST en GET en suivant la redirection, alors que 308 garantit que la méthode et le corps restent exactement les mêmes. Pour un point d'accès d'API qui accepte POST ou PUT, utilisez 308. La paire temporaire fonctionne de la même manière : 302 peut changer la méthode, 307 ne le doit pas.

Que signifie 304 Not Modified ?

C'est la réponse à une requête conditionnelle — envoyée avec If-None-Match ou If-Modified-Since — qui indique que la copie que le client possède déjà est toujours à jour ; aucun corps n'est donc envoyé. C'est ainsi que le cache économise de la bande passante, et ce n'est pas une erreur : beaucoup de 304 dans vos journaux signifie que le cache fonctionne.

Pour une erreur de validation, 422 ou 400 ?

Utilisez 400 quand la requête ne peut pas être lue du tout — JSON cassé, en-tête obligatoire manquant. Utilisez 422 Unprocessable Content quand elle est bien formée mais que son contenu ne peut pas être traité, par exemple un champ e-mail qui ne contient pas une adresse e-mail. 422 est né dans WebDAV et la RFC 9110 l'a intégré à HTTP en 2022 : ce n'est donc plus une extension.

Quelle est la différence entre 502, 503 et 504 ?

Les trois viennent généralement d'un proxy ou d'un répartiteur de charge plutôt que de votre application. 502 Bad Gateway signifie que le serveur placé derrière a envoyé une réponse invalide ou aucune réponse, souvent parce qu'il a planté. 503 Service Unavailable signifie que le serveur fonctionne mais ne peut pas traiter la requête pour l'instant — surchargé ou en maintenance — idéalement avec un en-tête Retry-After. 504 Gateway Timeout signifie que le serveur derrière le proxy a mis trop longtemps à répondre.

418 I'm a teapot est-il un vrai code de statut ?

Il est né d'une blague : la RFC 2324, une RFC de poisson d'avril de 1998, le définissait pour les cafetières à qui l'on demande du café alors que ce sont des théières. Il n'a jamais été destiné à être implémenté, mais tant de frameworks l'ont ajouté que la RFC 9110 marque désormais 418 comme réservé, pour qu'on ne puisse pas donner un vrai sens à ce numéro. L'utiliser en production, c'est faire une blague que les clients de votre API doivent comprendre.

Pourquoi 499, 509 et 520 n'y sont-ils pas ?

Ce ne sont pas des codes de statut HTTP enregistrés. 499 est journalisé par nginx quand le client a fermé la connexion avant la réponse, 509 Bandwidth Limit Exceeded vient de certains hébergeurs, et 520 à 526 sont les erreurs propres à Cloudflare quand il n'arrive pas à joindre le serveur d'origine. Chacun n'a de sens que pour ce produit ; la liste s'en tient donc au registre officiel.

Aidez-nous à améliorer cet outil

Un bug, une envie de changement, ou un outil qui vous manque ?

/http-status-codes

↑↓ pour se déplacer · Entrée pour ouvrir · Échap pour fermer