2xx · Succès
200
OK
La requête a réussi. Le contenu du corps dépend de la méthode : la ressource pour un GET, le résultat de l'action pour un POST.
Quand l'utiliser: La réponse par défaut à une requête qui a fonctionné. Quand quelque chose a été créé, 201 en dit plus.
Défini dans RFC 9110 §15.3.1
201
Created
La requête a réussi et a créé une ou plusieurs nouvelles ressources.
Quand l'utiliser: La réponse à un POST ou un PUT qui a créé quelque chose, avec un en-tête Location pointant vers la nouvelle ressource.
Défini dans RFC 9110 §15.3.2
202
Accepted
La requête a été acceptée pour traitement, mais le traitement n'est pas terminé et peut encore échouer.
Quand l'utiliser: Pour un travail exécuté en arrière-plan — une tâche en file d'attente, un import par lots — idéalement avec un lien où le client peut suivre l'avancement.
Défini dans RFC 9110 §15.3.3
203
Non-Authoritative Information
La requête a réussi, mais un proxy intermédiaire a modifié la réponse reçue du serveur d'origine.
Quand l'utiliser: Envoyé par des proxys qui transforment le contenu, pour signaler qu'il n'est pas exactement celui envoyé par l'origine. Rarement vu.
Défini dans RFC 9110 §15.3.4
204
No Content
La requête a réussi et la réponse n'a volontairement aucun corps.
Quand l'utiliser: Une réponse courante à un DELETE, ou à un PUT dont le client n'a pas besoin de copie en retour.
Défini dans RFC 9110 §15.3.5
205
Reset Content
La requête a réussi et le client doit réinitialiser la vue qui l'a envoyée, par exemple vider un formulaire.
Quand l'utiliser: Prévu pour les interfaces de saisie qui veulent un formulaire vide pour l'entrée suivante. En pratique, les navigateurs n'en font pas grand-chose.
Défini dans RFC 9110 §15.3.6
206
Partial Content
Le serveur n'envoie que la partie de la ressource que le client a demandée dans un en-tête Range.
Quand l'utiliser: C'est ainsi que l'avance rapide dans une vidéo, les téléchargements repris et les gestionnaires de téléchargement récupèrent un fichier par morceaux.
Défini dans RFC 9110 §15.3.7
207
Multi-Status
Une réponse WebDAV dont le corps XML contient un statut distinct pour chacune de plusieurs ressources.
Quand l'utiliser: Pour une seule requête qui a agi sur de nombreux éléments, dont certains ont pu réussir et d'autres échouer.
Défini dans RFC 4918
208
Already Reported
Utilisé à l'intérieur d'une réponse WebDAV 207 pour indiquer que les membres d'une ressource ont déjà été listés plus haut dans la même réponse.
Quand l'utiliser: Évite de répéter le même élément quand une collection est accessible par plusieurs liaisons.
Défini dans RFC 5842
226
IM Used
Le serveur a satisfait un GET et la réponse est le résultat de manipulations d'instance, comme un delta, appliquées à la ressource actuelle.
Quand l'utiliser: Fait partie du delta encoding HTTP (RFC 3229), où un client ne demande que ce qui a changé depuis sa copie. Rarement implémenté.
Défini dans RFC 3229
3xx · Redirection
300
Multiple Choices
La ressource a plusieurs représentations, et le client ou l'utilisateur doit en choisir une.
Quand l'utiliser: Peu utilisé, car il n'existe aucun moyen standard de choisir automatiquement ; les serveurs en choisissent généralement une et l'envoient.
Défini dans RFC 9110 §15.4.1
301
Moved Permanently
La ressource a une nouvelle adresse permanente, donnée dans l'en-tête Location, et les liens doivent être mis à jour vers elle.
Quand l'utiliser: Pour une page déplacée définitivement. Les moteurs de recherche transmettent son classement à la nouvelle adresse. Un client peut transformer un POST en GET en le suivant : utilisez 308 quand la méthode compte.
Défini dans RFC 9110 §15.4.2
302
Found
Aussi appelé: Moved Temporarily
La ressource se trouve temporairement à une autre adresse, donnée dans l'en-tête Location ; l'adresse d'origine reste la bonne à utiliser.
Quand l'utiliser: Pour un déplacement de courte durée, comme envoyer les visiteurs vers une page de connexion. Les clients peuvent changer POST en GET en le suivant ; 307 l'interdit.
Défini dans RFC 9110 §15.4.3
303
See Other
La réponse se trouve à une autre adresse, et le client doit la récupérer avec un GET.
Quand l'utiliser: La réponse classique après l'envoi d'un formulaire en POST (Post/Redirect/Get), pour que recharger la page de résultat ne renvoie pas le formulaire.
Défini dans RFC 9110 §15.4.4
304
Not Modified
La copie en cache du client est toujours à jour, donc le serveur n'envoie aucun corps.
Quand l'utiliser: La réponse à un GET conditionnel avec If-None-Match ou If-Modified-Since quand rien n'a changé. Ce n'est pas une erreur : c'est le cache qui fonctionne.
Défini dans RFC 9110 §15.4.5
305
Use Proxy
InutiliséIndiquait autrefois au client de répéter la requête via le proxy nommé dans l'en-tête Location.
Quand l'utiliser: Déprécié pour des raisons de sécurité, car il permettait à une réponse de faire passer le trafic par le proxy de son choix. Ne l'envoyez pas.
Défini dans RFC 9110 §15.4.6
306
(Unused)
InutiliséRéservé. Une version de travail antérieure le définissait comme Switch Proxy, et il n'a jamais été utilisé.
Quand l'utiliser: Ne l'envoyez jamais. Le numéro reste réservé pour ne pas être réutilisé.
Défini dans RFC 9110 §15.4.7
307
Temporary Redirect
La ressource se trouve temporairement à l'adresse de l'en-tête Location, et le client doit y répéter la requête avec la même méthode et le même corps.
Quand l'utiliser: La redirection temporaire à utiliser quand un POST doit rester un POST. Les passages de http à https imposés par HSTS apparaissent aussi en 307 dans les navigateurs.
Défini dans RFC 9110 §15.4.8
308
Permanent Redirect
La ressource a été déplacée définitivement à l'adresse de l'en-tête Location, et le client doit conserver la même méthode et le même corps.
Quand l'utiliser: Une redirection permanente pour une API ou tout point d'accès qui accepte POST ou PUT, là où un 301 pourrait transformer la requête en GET.
Défini dans RFC 9110 §15.4.9
4xx · Erreur du client
400
Bad Request
Le serveur ne peut pas traiter la requête à cause de ce qu'il considère comme une erreur du client, par exemple une syntaxe mal formée.
Quand l'utiliser: Pour une requête impossible à analyser : JSON cassé, en-tête invalide, paramètre obligatoire manquant.
Défini dans RFC 9110 §15.5.1
401
Unauthorized
La requête n'a pas d'identifiants d'authentification valides pour la ressource. Malgré son nom, il concerne l'authentification, pas l'autorisation.
Quand l'utiliser: Quand le client ne s'est pas connecté ou que son jeton a expiré. La réponse doit contenir un en-tête WWW-Authenticate indiquant comment s'authentifier.
Défini dans RFC 9110 §15.5.2
402
Payment Required
Réservé pour un usage futur. La spécification n'a jamais défini ce qu'il doit faire.
Quand l'utiliser: Certaines API l'envoient quand un abonnement a expiré ou qu'un paiement a échoué, mais aucun comportement standard ne l'encadre.
Défini dans RFC 9110 §15.5.3
403
Forbidden
Le serveur a compris la requête et refuse de la satisfaire. Renvoyer les mêmes identifiants ne changera pas la réponse.
Quand l'utiliser: Quand l'utilisateur est connu mais n'a pas le droit : le compte de quelqu'un d'autre, une page d'administration, un pays ou une adresse IP bloqués.
Défini dans RFC 9110 §15.5.4
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
405
Method Not Allowed
La méthode est connue du serveur mais n'est pas prise en charge par cette ressource.
Quand l'utiliser: Pour un POST vers une adresse en lecture seule, ou un DELETE là où rien ne peut être supprimé. La réponse doit lister les méthodes permises dans un en-tête Allow.
Défini dans RFC 9110 §15.5.6
406
Not Acceptable
Le serveur ne peut produire de réponse dans aucun des formats que le client a déclaré accepter dans ses en-têtes Accept.
Quand l'utiliser: Une négociation de contenu sans terrain commun, par exemple un client qui n'accepte que du XML face à une API qui ne parle que JSON. La plupart des serveurs envoient plutôt leur format par défaut.
Défini dans RFC 9110 §15.5.7
407
Proxy Authentication Required
Comme 401, mais c'est un proxy entre le client et le serveur qui demande au client de s'authentifier.
Quand l'utiliser: Envoyé par les proxys d'entreprise et autres proxys authentifiants, avec un en-tête Proxy-Authenticate indiquant comment faire.
Défini dans RFC 9110 §15.5.8
408
Request Timeout
Le serveur a cessé d'attendre que le client finisse d'envoyer sa requête.
Quand l'utiliser: Envoyé sur une connexion inactive avant que le serveur la ferme. Les clients peuvent simplement réessayer la requête sur une nouvelle connexion.
Défini dans RFC 9110 §15.5.9
409
Conflict
La requête entre en conflit avec l'état actuel de la ressource.
Quand l'utiliser: Une modification fondée sur une version périmée, un nom d'utilisateur déjà pris, ou l'envoi d'un fichier dont le nom est déjà utilisé.
Défini dans RFC 9110 §15.5.10
410
Gone
La ressource se trouvait ici et a été supprimée volontairement, sans adresse de renvoi.
Quand l'utiliser: Pour un contenu retiré définitivement. Il indique aux moteurs de recherche plus fermement que 404 que la page ne reviendra pas.
Défini dans RFC 9110 §15.5.11
411
Length Required
Le serveur refuse une requête qui a un corps mais pas d'en-tête Content-Length.
Quand l'utiliser: Envoyé par les serveurs qui n'acceptent pas les envois par morceaux de longueur inconnue.
Défini dans RFC 9110 §15.5.12
412
Precondition Failed
Une condition des en-têtes de la requête, comme If-Match ou If-Unmodified-Since, n'a pas été remplie.
Quand l'utiliser: Protège contre les mises à jour perdues : la ressource a changé depuis la dernière lecture du client, donc l'écriture est refusée.
Défini dans RFC 9110 §15.5.13
413
Content Too Large
Aussi appelé: Payload Too Large, Request Entity Too Large
Le corps de la requête est plus grand que ce que le serveur veut ou peut traiter. La RFC 9110 l'a renommé, il s'appelait Payload Too Large.
Quand l'utiliser: Un envoi qui dépasse la taille limite. Si la limite est temporaire, un en-tête Retry-After indique quand réessayer.
Défini dans RFC 9110 §15.5.14
414
URI Too Long
Aussi appelé: Request-URI Too Long
L'URI de la requête est plus longue que ce que le serveur accepte de lire.
Quand l'utiliser: Généralement un formulaire envoyé en GET avec une énorme chaîne de requête, ou une boucle de redirection qui allongeait sans cesse l'URL. Envoyez plutôt les données dans le corps d'un POST.
Défini dans RFC 9110 §15.5.15
415
Unsupported Media Type
Le serveur refuse la requête parce que le corps est dans un format qu'il ne prend pas en charge.
Quand l'utiliser: Un Content-Type erroné ou absent, par exemple des données de formulaire envoyées à un point d'accès qui n'accepte que application/json.
Défini dans RFC 9110 §15.5.16
416
Range Not Satisfiable
Aussi appelé: Requested Range Not Satisfiable
Aucune des plages de l'en-tête Range de la requête ne recouvre la ressource.
Quand l'utiliser: Demander des octets au-delà de la fin du fichier, souvent lors de la reprise du téléchargement d'un fichier devenu plus petit entre-temps.
Défini dans RFC 9110 §15.5.17
417
Expectation Failed
Le serveur ne peut pas satisfaire l'exigence de l'en-tête Expect de la requête.
Quand l'utiliser: Surtout vu quand un proxy ou un serveur ne prend pas en charge Expect: 100-continue. Réessayer sans cet en-tête fonctionne généralement.
Défini dans RFC 9110 §15.5.18
418
(Unused)
InutiliséAussi appelé: I'm a teapot
Le code de poisson d'avril de la RFC 2324 : une théière qui refuse de préparer du café. La RFC 9110 réserve ce numéro pour qu'il ne reçoive jamais de vrai sens.
Quand l'utiliser: Pas pour la production. Certains sites l'envoient comme clin d'œil ou pour repousser des robots, mais on ne peut pas attendre des clients qu'ils le comprennent.
Défini dans RFC 9110 §15.5.19
421
Misdirected Request
La requête a atteint un serveur qui ne peut pas produire de réponse pour l'hôte qu'elle nomme.
Quand l'utiliser: Survient surtout avec la réutilisation des connexions HTTP/2, quand une connexion est partagée entre des noms d'hôte pour lesquels le serveur n'est pas configuré. Le client doit réessayer sur une nouvelle connexion.
Défini dans RFC 9110 §15.5.20
422
Unprocessable Content
Aussi appelé: Unprocessable Entity
Le serveur comprend le type de contenu et la syntaxe est correcte, mais il ne peut pas traiter ce que contient la requête. Autrefois Unprocessable Entity.
Quand l'utiliser: La réponse habituelle à une erreur de validation dans une requête bien formée. Fait partie de HTTP lui-même depuis la RFC 9110, et plus seulement de WebDAV.
Défini dans RFC 9110 §15.5.21
423
Locked
La ressource WebDAV à laquelle on accède est verrouillée.
Quand l'utiliser: Un fichier qu'un autre utilisateur a verrouillé pour le modifier.
Défini dans RFC 4918
424
Failed Dependency
La requête a échoué parce qu'une autre action dont elle dépendait a échoué.
Quand l'utiliser: Dans un lot WebDAV, les opérations qui n'ont pas pu s'exécuter parce qu'une opération précédente de la même requête a échoué.
Défini dans RFC 4918
425
Too Early
Le serveur ne veut pas risquer de traiter une requête qui pourrait être rejouée.
Quand l'utiliser: Pour les requêtes envoyées en données précoces TLS 1.3 (0-RTT), qu'un attaquant pourrait répéter. Le client doit réessayer une fois la négociation terminée.
Défini dans RFC 8470
426
Upgrade Required
Le serveur refuse la requête avec le protocole actuel, mais l'accepterait après une mise à niveau du client.
Quand l'utiliser: Envoyé avec un en-tête Upgrade qui nomme le protocole exigé, par exemple une version plus récente de HTTP ou de TLS.
Défini dans RFC 9110 §15.5.22
428
Precondition Required
Le serveur exige que la requête soit conditionnelle, avec un en-tête comme If-Match.
Quand l'utiliser: Oblige les clients à prouver quelle version ils modifient, pour que deux modifications ne puissent pas s'écraser sans que personne ne s'en aperçoive.
Défini dans RFC 6585
429
Too Many Requests
Le client a envoyé trop de requêtes en un temps donné.
Quand l'utiliser: Limitation de débit. Un en-tête Retry-After indique combien de temps attendre ; les clients doivent ralentir plutôt que réessayer immédiatement.
Défini dans RFC 6585
431
Request Header Fields Too Large
Le serveur refuse de traiter la requête parce que ses en-têtes, ou un seul en-tête, sont trop volumineux.
Quand l'utiliser: Le plus souvent un cookie trop gros, ou trop de cookies pour un même domaine. Effacer les cookies du site règle généralement le problème.
Défini dans RFC 6585
451
Unavailable For Legal Reasons
Le serveur refuse l'accès à la ressource en raison d'une exigence légale.
Quand l'utiliser: Un contenu bloqué par décision de justice, à la demande d'un gouvernement ou par un retrait dans un pays. Le numéro est un clin d'œil au roman Fahrenheit 451.
Défini dans RFC 7725
5xx · Erreur du serveur
500
Internal Server Error
Le serveur a rencontré une situation inattendue qui l'a empêché de satisfaire la requête.
Quand l'utiliser: Le code fourre-tout pour un plantage ou une exception non gérée. Les journaux du serveur disent ce qui s'est vraiment passé ; le client ne peut généralement rien y faire.
Défini dans RFC 9110 §15.6.1
501
Not Implemented
Le serveur ne prend pas en charge la fonctionnalité nécessaire pour satisfaire la requête.
Quand l'utiliser: Une méthode que le serveur ne reconnaît pas du tout. Contrairement à 405, cela signifie qu'aucune ressource de ce serveur ne la prend en charge.
Défini dans RFC 9110 §15.6.2
502
Bad Gateway
Un serveur agissant comme passerelle ou proxy a reçu une réponse invalide, ou aucune réponse, du serveur placé derrière lui.
Quand l'utiliser: L'application derrière nginx, un répartiteur de charge ou un CDN a planté, redémarre ou est injoignable.
Défini dans RFC 9110 §15.6.3
503
Service Unavailable
Le serveur ne peut pas traiter la requête pour le moment, parce qu'il est surchargé ou en maintenance.
Quand l'utiliser: Une situation temporaire. Envoyez un en-tête Retry-After indiquant quand revenir ; les moteurs de recherche traitent un 503 comme temporaire et conservent la page.
Défini dans RFC 9110 §15.6.4
504
Gateway Timeout
Un serveur agissant comme passerelle ou proxy n'a pas reçu à temps de réponse du serveur placé derrière lui.
Quand l'utiliser: Une requête de base de données lente, ou un backend qui met plus longtemps à répondre que le délai du proxy.
Défini dans RFC 9110 §15.6.5
505
HTTP Version Not Supported
Le serveur ne prend pas en charge la version majeure de HTTP utilisée dans la requête.
Quand l'utiliser: Rare, puisque presque tous les serveurs parlent HTTP/1.1, HTTP/2 et souvent HTTP/3.
Défini dans RFC 9110 §15.6.6
506
Variant Also Negotiates
Une erreur de configuration du serveur dans la négociation de contenu transparente : la variante choisie est elle-même configurée pour négocier, ce qui tournerait en boucle.
Quand l'utiliser: Vient de la négociation de contenu expérimentale (RFC 2295) et ne se voit presque jamais.
Défini dans RFC 2295
507
Insufficient Storage
Le serveur ne peut pas stocker ce que la requête lui demande de stocker.
Quand l'utiliser: Un envoi ou une copie WebDAV quand le disque ou le quota de l'utilisateur est plein.
Défini dans RFC 4918
508
Loop Detected
Le serveur a arrêté une opération WebDAV parce qu'il a détecté une boucle infinie.
Quand l'utiliser: Une requête avec Depth: infinity à travers des liaisons qui pointent les unes vers les autres.
Défini dans RFC 5842
510
Not Extended
InutiliséLa requête a besoin d'extensions supplémentaires que le serveur exige avant de la satisfaire.
Quand l'utiliser: Vient du HTTP Extension Framework (RFC 2774), passé depuis au statut historique, et le registre marque ce code comme obsolète. Ne l'envoyez pas.
Défini dans RFC 2774
511
Network Authentication Required
Le client doit s'authentifier pour obtenir tout simplement un accès au réseau.
Quand l'utiliser: Envoyé par les portails captifs, comme les pages de connexion Wi-Fi des hôtels ou des aéroports, qui interceptent le trafic jusqu'à ce que l'utilisateur se connecte.
Défini dans RFC 6585