Référence des codes d’état HTTP
| Code | Nom | Signification |
|---|---|---|
| 100 | Continuer | Le client doit continuer avec le corps de la requête |
| 101 | Changement de protocoles | Mise à niveau de protocole acceptée (par exemple vers WebSocket) |
| 200 | OK | La requête a réussi — la réponse de succès par défaut |
| 201 | Créé | Une nouvelle ressource a été créée (succès POST typique) |
| 202 | Accepté | Mis en file d’attente pour un traitement asynchrone, pas encore terminé |
| 204 | Aucun contenu | Succès avec un corps intentionnellement vide |
| 301 | Déplacé définitivement | La ressource a une nouvelle URL permanente — mettez à jour les liens ; l’équité SEO se transfère |
| 302 | Trouvé | Redirection temporaire (historiquement mal utilisée ; voir 303/307) |
| 303 | Voir autre | Redirection vers un GET à une autre URL (post/redirect/get) |
| 304 | Non modifié | La copie en cache est toujours valide — revalidez via ETag/Last-Modified |
| 307 | Redirection temporaire | Redirection temporaire préservant la méthode et le corps |
| 308 | Redirection permanente | Redirection permanente préservant la méthode et le corps |
| 400 | Requête incorrecte | Le serveur ne peut pas analyser/comprendre la requête |
| 401 | Non autorisé | Authentification requise ou échouée (malgré le nom, cela signifie non authentifié) |
| 403 | Interdit | Authentifié ou non, l’accès est refusé |
| 404 | Introuvable | Aucune ressource à cette URL |
| 405 | Méthode non autorisée | La méthode HTTP n’est pas prise en charge pour cette ressource |
| 406 | Non acceptable | Aucune représentation ne correspond aux en-têtes Accept |
| 408 | Délai de requête dépassé | Le client a mis trop de temps à envoyer la requête |
| 409 | Conflit | Conflit d’état, par exemple collision de modification ou création en double |
| 410 | Disparu (Gone) | Supprimé définitivement (plus fort que 404 — utilisé délibérément) |
| 411 | Longueur requise | L’en-tête Content-Length est requis |
| 413 | Contenu trop volumineux | Le corps de la requête dépasse les limites du serveur |
| 414 | URI trop longue | L’URL dépasse les limites du serveur |
| 415 | Type de média non pris en charge | Le Content-Type de la requête n’est pas pris en charge |
| 418 | Je suis une théière (I’m a Teapot) | Code de plaisanterie de la RFC 2324, utilisé occasionnellement pour refuser de préparer du café |
| 422 | Contenu non traitable | La syntaxe est correcte mais la sémantique échoue à la validation (les API adorent celui-ci) |
| 425 | Trop tôt | Serveur peu disposé à traiter une requête possiblement rejouée |
| 429 | Trop de requêtes | Limite de débit atteinte — reculez, honorez Retry-After |
| 500 | Erreur interne du serveur | Échec générique côté serveur |
| 501 | Non implémenté | Le serveur ne prend pas en charge la fonctionnalité |
| 502 | Passerelle incorrecte | Un proxy/passerelle a reçu une réponse invalide de l’amont |
| 503 | Service indisponible | Surchargé ou arrêté pour maintenance — souvent temporaire, peut porter Retry-After |
| 504 | Délai de passerelle dépassé | Un proxy/passerelle a dépassé le délai en attendant l’amont |
| 505 | Version HTTP non prise en charge | La version HTTP de la requête n’est pas prise en charge |
À propos
Les codes d’état sont le résumé en un nombre du serveur pour chaque réponse, groupés par classe : 1xx informationnel, 2xx succès, 3xx redirection, 4xx le client a erré, 5xx le serveur a erré. Le tableau donne les codes que les développeurs en activité rencontrent réellement, avec les nuances qui comptent en pratique — 401 signifie non authentifié malgré son nom, 403 est un refus quel que soit l’état de connexion, 422 est l’échec de validation d’API, 429 exige un recul. Les codes non listés (la longue traîne des 1xx et des codes expérimentaux) sont assez rares pour que la classe seule vous dise comment les gérer.
Questions fréquemment posées
Quelle est la différence entre 401 et 403 ?
401 : nous ne savons pas qui vous êtes (authentifiez-vous). 403 : nous le savons, et vous n’avez quand même pas le droit.
302 ou 307 pour une redirection temporaire ?
307 préserve la méthode et le corps ; 302 laissait historiquement les clients passer de POST à GET. Les travaux nouveaux devraient utiliser 307 (ou 308 pour le permanent).