Diagnostiquer une erreur d'API
Retrouvez rapidement le sens et le contexte habituel de codes comme 401, 403, 409 ou 422.
Guide
La page Codes de statut HTTP est une référence intégrée à l'application : vous pouvez la parcourir par code, nom anglais, signification ou description, et la filtrer par classe 1xx information, 2xx succès, 3xx redirection, 4xx erreur client et 5xx erreur serveur. Ce sont des connaissances statiques : la page n'envoie aucune requête HTTP au domaine ni à l'endpoint que vous saisissez.
Mis à jour le 2026-09-102 min read
La page Codes de statut HTTP est une référence intégrée à l'application : vous pouvez la parcourir par code, nom anglais, signification ou description, et la filtrer par classe 1xx information, 2xx succès, 3xx redirection, 4xx erreur client et 5xx erreur serveur. Ce sont des connaissances statiques : la page n'envoie aucune requête HTTP au domaine ni à l'endpoint que vous saisissez.
404, « délai d'attente » ou un nom de statut, ou laissez le champ vide pour tout parcourir.| Entrée | Sortie | Remarque |
|---|---|---|
404 |
La fiche 404 Not Found | recherche par code exact |
| « redirection » | Descriptions 3xx correspondantes | recherche textuelle |
| Sélection de 5xx | Uniquement les erreurs serveur | filtrage local |
HTTP_STATUS intégrée au dépôt ; leur couverture suit la version de l'application et ne se synchronise pas en ligne avec le registre IANA.fetch : elle ne peut pas vous dire quel code de statut un site renvoie actuellement.Retrouvez rapidement le sens et le contexte habituel de codes comme 401, 403, 409 ou 422.
Parcourez les groupes 2xx/3xx/4xx/5xx pour acquérir les notions de base du protocole.
Non. Cette page n'a aucune capacité réseau : elle ne consulte qu'une table de codes locale.
Non, c'est une donnée intégrée, publiée avec l'application.
Le mot-clé de recherche ne filtre qu'une table statique en local ; aucune requête réseau n'est envoyée.
Mis à jour le 2026-09-10
Aide-mémoire complet des codes 1xx–5xx, avec signification et cas d’usage
Cet outil n’est pas entièrement traduit ; certains contenus utilisent la langue source ou une langue de repli.
Le serveur a reçu les en-têtes de la requête et le client doit continuer d’envoyer le corps. Fréquent avant l’envoi de gros fichiers avec Expect: 100-continue.
Le serveur accepte de changer de protocole, le plus souvent lors d’une mise à niveau WebSocket (Upgrade: websocket).
Extension WebDAV : la requête a été reçue et est en cours de traitement, mais aucune réponse n’est encore prête. Évite un délai d’attente côté client.
Renvoie une partie des en-têtes avant la réponse finale, souvent avec un en-tête Link pour que le navigateur précharge les ressources CSS/JS.
La requête a réussi. GET renvoie le contenu de la ressource, POST le résultat du traitement. Le code le plus courant.
La ressource a été créée, généralement après un POST/PUT qui crée un enregistrement, avec un en-tête Location pointant vers la nouvelle ressource.
La requête a été acceptée mais n’est pas encore traitée ; adapté aux tâches asynchrones (traitement de files d’attente, import par lots).
Les métadonnées renvoyées proviennent d’une copie locale ou tierce (modifiée par un proxy, par exemple), et non de la version faisant autorité du serveur d’origine.
Traitement réussi sans contenu renvoyé. Fréquent après un DELETE réussi ou un enregistrement de formulaire sans redirection.
Traitement réussi ; le client doit réinitialiser sa vue (vider un formulaire, par exemple). Rarement utilisé en pratique.
Une requête partielle a réussi et renvoie une partie de la ressource. La lecture avec déplacement dans une vidéo et les téléchargements reprenables en dépendent (en-tête Range).
Extension WebDAV : une requête porte plusieurs opérations et le corps XML indique chaque statut séparément.
Extension WebDAV : les membres liés ont déjà été énumérés dans une réponse précédente et ne sont pas listés à nouveau.
Le serveur a satisfait une requête GET et la réponse résulte de l’application de manipulations d’instance (encodage delta).
La ressource a plusieurs représentations possibles (versions linguistiques, par exemple) et le client ou l’utilisateur doit en choisir une.
La ressource a définitivement déménagé vers une nouvelle adresse et les moteurs de recherche mettront à jour leur index. Courant pour changer de domaine ou passer de HTTP à HTTPS.
La ressource se trouve temporairement à une autre adresse. Historiquement, les clients peuvent transformer POST en GET ; utilisez 307 pour conserver la méthode.
Le client doit récupérer le résultat à une autre adresse avec GET — le schéma classique post/redirect/get après un formulaire.
La ressource n’a pas changé depuis la dernière requête ; la copie en cache local peut être réutilisée. Fonctionne avec ETag / Last-Modified.
(Obsolète) La ressource doit être accessible via le proxy indiqué. Les navigateurs modernes ne le prennent plus en charge pour des raisons de sécurité.
Comme 302, mais la méthode et le corps de la requête ne doivent pas changer lors de la redirection (POST reste POST).
Comme 301, mais la méthode et le corps de la requête sont conservés — adapté au déplacement définitif d’une API.
Le serveur ne peut pas comprendre la requête : paramètre manquant, JSON mal formé, syntaxe invalide, etc. Le client doit corriger la requête.
Identifiants manquants ou invalides (jeton expiré, par exemple). Sémantiquement « non connecté » : invitez l’utilisateur à s’authentifier.
Code réservé que certaines API utilisent pour signaler un quota épuisé ou la nécessité d’un abonnement payant.
L’identité est connue mais n’a pas la permission d’accéder à la ressource (utilisateur ordinaire sur une interface d’administration, par exemple). Contrairement à 401, il s’agit d’autorisation.
La ressource demandée n’existe pas : URL erronée ou ressource supprimée. Le code le plus connu.
La ressource ne prend pas en charge cette méthode HTTP (un POST sur une interface en lecture seule, par exemple). La réponse doit lister les méthodes autorisées dans l’en-tête Allow.
Le serveur ne peut pas produire un format conforme à l’en-tête Accept (le client n’accepte que du XML alors que le serveur n’a que du JSON, par exemple).
Comme 401, mais une authentification auprès du serveur proxy est requise au préalable.
Le serveur a dépassé le délai d’attente de l’envoi de la requête (réseau lent ou client interrompu). Le client peut réessayer plus tard.
La requête entre en conflit avec l’état actuel de la ressource : création en double, modifications concurrentes, etc.
La ressource a existé mais a été supprimée définitivement et ne reviendra pas. Plus explicite qu’un 404, utile pour que les moteurs de recherche la retirent de leur index.
Le serveur exige que la requête comporte un en-tête Content-Length.
Un en-tête conditionnel comme If-Match n’est pas satisfait — souvent un verrouillage optimiste qui empêche d’écraser une ressource modifiée par quelqu’un d’autre.
Le corps de la requête dépasse la limite du serveur, typiquement lors d’un envoi trop gros (réglage client_max_body_size de nginx, par exemple).
L’URL demandée dépasse la longueur acceptée par le serveur, souvent à cause d’un excès de paramètres GET ; passez à POST.
Le format du corps de la requête n’est pas pris en charge, par exemple un formulaire envoyé à une API qui attend application/json.
La plage demandée dans l’en-tête Range dépasse la taille réelle de la ressource — fréquent quand les informations locales d’un téléchargement reprenable ne correspondent plus au fichier du serveur.
Le serveur ne peut pas satisfaire l’en-tête Expect (100-continue non pris en charge, par exemple).
Poisson d’avril 1998 (protocole HTCPCP) : la théière refuse de préparer du café. Certains sites l’utilisent comme réponse anti-robot ludique.
La requête a atteint un serveur incapable de produire une réponse, souvent via une connexion HTTP/2 réutilisée vers le mauvais hôte virtuel.
La syntaxe est correcte mais la sémantique est invalide : échec de validation d’un champ (adresse e-mail mal formée, par exemple). Les API REST l’utilisent pour les erreurs de formulaire.
Extension WebDAV : la ressource est verrouillée et l’opération en cours ne peut pas aboutir.
Extension WebDAV : la requête en cours ne peut pas aboutir car une requête précédente a échoué.
Le serveur refuse de traiter des données précoces susceptibles d’être rejouées (TLS 1.3 0-RTT) afin d’éviter les attaques par rejeu.
Le serveur refuse de traiter la requête avec le protocole actuel et demande au client de passer à un autre ; l’en-tête Upgrade indique le protocole cible.
Le serveur exige un en-tête conditionnel (If-Match, par exemple) pour forcer un verrouillage optimiste et éviter les pertes de mise à jour.
La limite de débit est atteinte. La réponse peut inclure un en-tête Retry-After indiquant quand réessayer — le code standard de limitation des API.
La taille totale des en-têtes ou celle d’un seul champ dépasse la limite, souvent à cause de cookies trop volumineux.
La ressource est refusée pour des raisons légales (droits d’auteur, blocage réglementaire). Le numéro fait référence au roman Fahrenheit 451.
Le serveur a rencontré une erreur inattendue en traitant la requête (exception non capturée, bug). Consultez les journaux du serveur.
Le serveur ne prend pas en charge cette méthode ou fonctionnalité, par exemple PATCH sur un serveur qui ne gère que GET/POST.
La passerelle ou le proxy inverse a reçu une réponse invalide du serveur amont — souvent un backend planté ou une connexion amont refusée par nginx.
Le serveur est temporairement surchargé ou en maintenance et peut renvoyer un en-tête Retry-After. Fréquent lors d’une montée en charge, d’un déploiement ou d’un disjoncteur.
La passerelle ou le proxy a dépassé le délai d’attente de la réponse du serveur amont, souvent parce que le backend est lent ou qu’une requête SQL lente pénalise l’interface.
Le serveur ne prend pas en charge la version du protocole HTTP utilisée par la requête.
Erreur de configuration de la négociation de contenu : la variante sélectionnée participe elle-même à la négociation, créant une boucle.
Extension WebDAV : le serveur n’a pas assez d’espace pour ce que la requête nécessite (disque plein, par exemple).
Extension WebDAV : une boucle infinie a été détectée pendant le traitement de la requête (cycle de liaisons, par exemple).
La requête ne contient pas les extensions exigées par le serveur ; elle doit être étendue avant de réessayer (très rarement utilisé).
Une authentification au niveau du réseau est nécessaire avant d’accéder à Internet — cas typique : le portail captif d’un Wi-Fi d’hôtel ou d’aéroport.