Reference des codes de statut HTTP

Comprendre les codes de statut HTTP

Les codes de statut HTTP sont des nombres a trois chiffres qu'un serveur renvoie en reponse a chaque requete HTTP. Ils font partie de la specification HTTP et fournissent un moyen standardise pour les serveurs de communiquer le resultat d'une requete au client. Lorsque vous visitez une page web, votre navigateur envoie une requete HTTP au serveur, et le serveur repond avec un code de statut accompagne du contenu demande ou d'un message d'erreur. Comprendre ces codes est fondamental pour le developpement web, la conception d'API, l'administration de serveurs et le debogage des problemes reseau.

Les codes de statut sont regroupes en cinq classes selon leur premier chiffre. Chaque classe represente un type de reponse different. Les codes 1xx sont informatifs, indiquant que la requete a ete recue et que le traitement se poursuit. Les codes 2xx signalent le succes, signifiant que la requete a ete recue, comprise et acceptee. Les codes 3xx indiquent une redirection, demandant au client d'effectuer une action supplementaire pour completer la requete. Les codes 4xx representent des erreurs client, ou la requete contient une syntaxe incorrecte ou ne peut pas etre satisfaite. Les codes 5xx indiquent des erreurs serveur, ou le serveur n'a pas reussi a satisfaire une requete valide.

Les cinq categories de codes de statut

Reponses informationnelles 1xx

Les reponses informationnelles indiquent que le serveur a recu la requete et continue de la traiter. La plus notable est 100 Continue, qui indique au client de poursuivre l'envoi du corps de la requete apres avoir envoye uniquement les en-tetes. Ceci est utile pour les telechargements volumineux ou le client souhaite verifier si le serveur acceptera la requete avant de transmettre une charge potentiellement importante. Le 103 Early Hints est un ajout plus recent qui permet au serveur d'envoyer des en-tetes preliminaires avant la reponse finale, permettant au navigateur de precharger les feuilles de style et les scripts pendant que le serveur prepare la reponse principale.

Codes de succes 2xx

Les codes de succes confirment que la requete a ete traitee correctement. Le 200 OK est le plus courant, renvoye pour les requetes GET reussies standard. Le 201 Created est utilise lorsqu'une nouvelle ressource a ete creee, generalement en reponse a une requete POST. Le 204 No Content indique un succes sans corps de reponse, couramment utilise pour les operations DELETE et les actions API qui n'ont pas besoin de renvoyer de donnees. Le 206 Partial Content prend en charge les requetes de plage, permettant aux clients de telecharger des fichiers volumineux par morceaux ou de reprendre des telechargements interrompus.

Codes de redirection 3xx et codes d'erreur 4xx/5xx

Les codes de redirection demandent au client de chercher la ressource demandee ailleurs. La distinction entre 301 Moved Permanently et 302 Found est cruciale pour le SEO, car les moteurs de recherche les traitent differemment lors du transfert de l'autorite des liens. Les codes d'erreur client de la plage 4xx couvrent tout, des requetes malformees (400) aux echecs d'authentification (401, 403), en passant par les ressources manquantes (404) et la limitation de debit (429). Les codes d'erreur serveur de la plage 5xx indiquent des problemes cote serveur, des defaillances generales (500) aux reponses de passerelle incorrecte (502) et a l'indisponibilite du service (503). La surveillance de ces codes aide les equipes d'exploitation a identifier et resoudre les problemes rapidement.

Codes de statut courants dans le developpement d'API

Les API RESTful s'appuient fortement sur les codes de statut pour communiquer les resultats. Une API bien concue utilise 200 pour les lectures reussies, 201 pour les creations reussies, 204 pour les suppressions reussies, 400 pour les erreurs de validation, 401 pour l'authentification manquante, 403 pour les permissions insuffisantes, 404 pour les ressources inexistantes, 409 pour les conflits comme les doublons, 422 pour les requetes semantiquement invalides et 429 pour les requetes soumises a une limitation de debit. L'utilisation coherente des codes de statut rend les API previsibles et plus faciles a integrer pour les consommateurs.

Foire aux questions

Que sont les codes de statut HTTP ?

Des nombres a trois chiffres renvoyes par les serveurs web indiquant le resultat d'une requete. Ils sont regroupes en cinq classes : 1xx Information, 2xx Succes, 3xx Redirection, 4xx Erreur client et 5xx Erreur serveur.

Que signifient les codes de statut 4xx ?

Les codes 4xx indiquent des erreurs client. La requete etait malformee, non autorisee ou pointait vers une ressource manquante. Les exemples courants incluent 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found et 429 Too Many Requests.

Quelle est la difference entre les redirections 301 et 302 ?

301 est une redirection permanente qui indique aux navigateurs et aux moteurs de recherche de mettre a jour leurs URL. 302 est une redirection temporaire ou l'URL d'origine doit toujours etre utilisee pour les requetes futures. 301 transmet l'autorite SEO des liens ; 302 ne le fait pas.

Qu'est-ce que le code de statut HTTP 418 ?

Un poisson d'avril de la RFC 2324 qui definit le protocole Hyper Text Coffee Pot Control Protocol. Une theiere renvoie 418 lorsqu'on lui demande de preparer du cafe. Malgre son caractere humoristique, il a ete largement implemente comme easter egg.

Quand utiliser une reponse 204 No Content ?

Utilisez 204 pour les requetes reussies qui n'ont pas besoin de corps de reponse, comme les operations DELETE, les mises a jour reussies ou le client possede deja les donnees, et les actions API de type fire-and-forget.