Référence des codes d'état HTTP

Consultez la signification d'un code d'état HTTP.

1xx Informatif
100ContinueLa première partie de la requête a été reçue ; le client doit continuer à envoyer le reste de la requête.
101Switching ProtocolsLe serveur change de protocole à la demande du client, par exemple pour passer à WebSocket.
102ProcessingLe serveur a accepté la requête complète mais n'a pas encore terminé de la traiter (WebDAV).
103Early HintsPermet au client de commencer à précharger des ressources pendant que le serveur prépare encore la réponse finale.
2xx Succès
200OKLa requête a réussi et le corps de la réponse contient la ressource demandée.
201CreatedLa requête a réussi et une nouvelle ressource a été créée en conséquence.
202AcceptedLa requête a été acceptée pour traitement, mais celui-ci n'est pas encore terminé.
203Non-Authoritative InformationLes métadonnées renvoyées ne proviennent pas du serveur d'origine mais d'une copie tierce ou d'un cache local.
204No ContentLa requête a réussi, mais il n'y a aucun contenu à renvoyer.
205Reset ContentLa requête a réussi ; le client doit réinitialiser la vue du document qui a envoyé la requête.
206Partial ContentSeule une partie de la ressource est livrée, conformément à une requête de plage d'octets.
207Multi-StatusTransmet des informations sur plusieurs ressources dans des situations où plusieurs codes de statut pourraient être appropriés (WebDAV).
208Already ReportedLes membres d'une liaison WebDAV ont déjà été listés dans une partie précédente de la réponse.
226IM UsedLe serveur a satisfait une requête en utilisant une ou plusieurs manipulations d'instance.
3xx Redirection
300Multiple ChoicesLa requête a plusieurs réponses possibles ; le client doit en choisir une.
301Moved PermanentlyLa ressource a été déplacée de façon permanente vers une nouvelle URL indiquée dans la réponse.
302FoundLa ressource se trouve temporairement à une autre URL ; les futures requêtes doivent continuer à utiliser l'URL d'origine.
303See OtherLa réponse peut être trouvée à une autre URL en utilisant une requête GET.
304Not ModifiedLa ressource n'a pas changé depuis la version indiquée par les en-têtes de cache du client.
307Temporary RedirectLa ressource se trouve temporairement à une autre URL ; contrairement au 302, la méthode de requête d'origine doit être réutilisée.
308Permanent RedirectLa ressource a été déplacée de façon permanente vers une nouvelle URL ; la méthode de requête d'origine doit être réutilisée.
4xx Erreur client
400Bad RequestLe serveur n'a pas pu comprendre la requête en raison d'une syntaxe invalide.
401UnauthorizedUne authentification est requise ; elle a échoué ou n'a pas été fournie.
402Payment RequiredRéservé pour un usage futur ; initialement prévu pour les systèmes de paiement numérique.
403ForbiddenLe client n'a pas les droits d'accès au contenu, même si la requête est comprise.
404Not FoundLe serveur ne trouve pas la ressource demandée.
405Method Not AllowedLa méthode de requête est connue mais n'est pas prise en charge par la ressource cible.
406Not AcceptableLe serveur ne peut pas produire une réponse correspondant aux en-têtes Accept du client.
407Proxy Authentication RequiredUne authentification auprès d'un proxy est requise avant que la requête puisse continuer.
408Request TimeoutLe serveur a dépassé le délai d'attente de la requête du client.
409ConflictLa requête est en conflit avec l'état actuel de la ressource cible.
410GoneLa ressource demandée n'est plus disponible et a été définitivement supprimée.
411Length RequiredLe serveur exige un en-tête Content-Length qui était absent de la requête.
412Precondition FailedUne condition préalable spécifiée dans les en-têtes de la requête n'a pas été satisfaite par le serveur.
413Payload Too LargeLe corps de la requête est plus volumineux que ce que le serveur est prêt ou capable de traiter.
414URI Too LongL'URI demandé est plus long que ce que le serveur est prêt à interpréter.
415Unsupported Media TypeLe format multimédia de la requête n'est pas pris en charge par le serveur.
416Range Not SatisfiableLa plage d'octets demandée ne peut pas être satisfaite compte tenu de la taille de la ressource.
417Expectation FailedLe serveur ne peut pas satisfaire l'attente indiquée dans l'en-tête Expect de la requête.
418I'm a TeapotUn statut humoristique défini comme une blague du 1er avril dans la RFC 2324 ; les serveurs ne devraient pas préparer de café.
421Misdirected RequestLa requête a été envoyée à un serveur incapable de produire une réponse pour l'URI cible.
422Unprocessable ContentLa requête était bien formée mais contient des erreurs sémantiques empêchant son traitement.
423LockedLa ressource à laquelle on accède est verrouillée (WebDAV).
424Failed DependencyLa requête a échoué car elle dépendait d'une autre requête qui a échoué (WebDAV).
425Too EarlyLe serveur refuse de traiter une requête susceptible d'être rejouée.
426Upgrade RequiredLe client doit passer à un autre protocole indiqué dans l'en-tête Upgrade.
428Precondition RequiredLe serveur d'origine exige que la requête soit conditionnelle.
429Too Many RequestsLe client a envoyé trop de requêtes dans un laps de temps donné (limitation de débit).
431Request Header Fields Too LargeLe serveur ne traitera pas la requête car ses champs d'en-tête sont trop volumineux.
451Unavailable For Legal ReasonsLa ressource est indisponible pour des raisons légales, comme une censure imposée par un gouvernement.
5xx Erreur serveur
500Internal Server ErrorLe serveur a rencontré une condition inattendue qui l'a empêché de traiter la requête.
501Not ImplementedLe serveur ne prend pas en charge la fonctionnalité nécessaire pour traiter la requête.
502Bad GatewayLe serveur, agissant comme passerelle, a reçu une réponse invalide d'un serveur en amont.
503Service UnavailableLe serveur n'est pas prêt à traiter la requête, souvent en raison d'une maintenance ou d'une surcharge.
504Gateway TimeoutLe serveur, agissant comme passerelle, n'a pas reçu de réponse à temps d'un serveur en amont.
505HTTP Version Not SupportedLa version HTTP utilisée dans la requête n'est pas prise en charge par le serveur.
506Variant Also NegotiatesLe serveur présente une erreur de configuration interne dans la négociation de contenu.
507Insufficient StorageLe serveur ne peut pas stocker la représentation nécessaire pour mener à bien la requête (WebDAV).
508Loop DetectedLe serveur a détecté une boucle infinie lors du traitement de la requête (WebDAV).
510Not ExtendedDes extensions supplémentaires à la requête sont nécessaires pour que le serveur puisse la satisfaire.
511Network Authentication RequiredLe client doit s'authentifier pour obtenir l'accès au réseau, souvent affiché par les portails captifs.

Exemples d'utilisation

Comprendre ce que signifie le code de statut d'une réponse API

Recherchez un code inconnu comme 422 renvoyé par une API backend pour voir rapidement ce qu'il signifie et comment y réagir.

Choisir le bon code de redirection

Vérifiez la différence entre 301 et 308, ou 302 et 307, pour décider quel statut de redirection utiliser lors du déplacement d'une URL.

Rechercher un code vu dans l'onglet réseau du navigateur

Recherchez un code de statut que vous avez repéré dans l'onglet réseau des outils de développement de votre navigateur pour comprendre pourquoi une requête a échoué.

Distinguer 401 et 403 lors du débogage de l'authentification

Recherchez '401' et '403' côte à côte pour voir la distinction exacte : 401 signifie que la requête n'a pas d'identifiants valides, tandis que 403 signifie que les identifiants sont valides mais que l'utilisateur n'a pas le droit d'accéder à la ressource.

Décider comment gérer la limitation de débit dans un client

Consultez 429 pour confirmer qu'il signifie trop de requêtes sur une période donnée, et vérifiez si la réponse de votre API inclut un en-tête Retry-After à respecter avant de réessayer.

Questions fréquentes

Tous les codes de cette liste sont-ils vraiment standards?

Oui — cette liste comprend uniquement les codes enregistrés dans le registre officiel des codes de statut HTTP de l'IANA qui sont couramment utilisés. Les codes non standards ou non officiels ne sont pas inclus.

Pourquoi des codes comme 305 et 306 sont-ils absents?

Le 305 (Use Proxy) est en pratique obsolète pour des raisons de sécurité, et le 306 n'est pas utilisé. Comme vous avez très peu de chances de les rencontrer en pratique, la liste se concentre sur les codes que vous rencontrerez réellement.

Ces descriptions remplacent-elles la spécification complète ou un conseil juridique?

Non — ce sont de courts résumés destinés à une consultation rapide. Si le comportement exact compte, consultez directement la RFC concernée ou la spécification HTTP actuelle.

Quelle est la vraie différence entre 401 et 403?

401 Unauthorized signifie en réalité « non authentifié » — le serveur ne sait pas qui vous êtes, généralement parce que les identifiants sont absents ou invalides. 403 Forbidden signifie que le serveur sait qui vous êtes mais que vous n'avez pas la permission d'accéder à cette ressource, même avec des identifiants valides.

Dois-je utiliser 404 ou 410 quand une ressource a disparu?

Utilisez 404 Not Found lorsqu'une ressource n'existe pas et que vous ne savez pas (ou ne voulez pas dire) si elle a déjà existé. Utilisez 410 Gone lorsque vous savez avec certitude qu'une ressource existait mais a été définitivement supprimée — cela indique aux clients et aux moteurs de recherche de cesser de la demander.

Quand utiliser 301, 302, 307 ou 308 pour une redirection?

301 et 308 sont des redirections permanentes ; 302 et 307 sont temporaires. La différence entre l'ancienne paire (301/302) et la nouvelle (307/308) est que 307 et 308 garantissent que la méthode et le corps de la requête sont conservés sur la requête redirigée, alors que 301 et 302 permettent historiquement aux clients de transformer un POST en GET.

Pourquoi mon serveur a-t-il renvoyé un 500 plutôt qu'un code plus précis?

500 Internal Server Error est un code fourre-tout générique pour les défaillances inattendues côté serveur, comme une exception non gérée. Il signifie généralement que la gestion des erreurs du serveur n'a pas associé la défaillance à un code 4xx ou 5xx plus précis — consultez les journaux de votre serveur pour connaître la cause réelle.