HTTP
Réponses HTTP

Paramètres

Format de réponse de base

Lorsqu'un serveur HTTP reçoit une requête HTTP bien formée, il doit traiter les informations contenues dans la demande et renvoyer une réponse au client. Une simple réponse HTTP 1.1 peut ressembler à l'une des suivantes, généralement suivie d'un certain nombre de champs d'en-tête et éventuellement d'un corps de réponse:

HTTP/1.1 200 OK \r\n

HTTP/1.1 404 Not Found \r\n

HTTP/1.1 503 Service Unavailable \r\n

Une simple réponse HTTP 1.1 a ce format:

HTTP-Version Status-Code Reason-Phrase CRLF

Comme dans une requête, HTTP-Version indique la version du protocole HTTP utilisée; pour HTTP 1.1, cela doit toujours être la chaîne HTTP/1.1 .

Status-Code est un Status-Code trois chiffres qui indique l'état de la demande du client. Le premier chiffre de ce code est la classe de statut , qui place le code de statut dans l'une des 5 catégories de réponse ^[1] :

• 1xx Informational - le serveur a reçu la demande et le traitement se poursuit
• 2xx Success - le serveur a accepté et traité la demande
• Redirection 3xx - une action supplémentaire est nécessaire chez le client pour compléter la demande
• Erreurs client 4xx - le client a envoyé une requête mal formée ou ne pouvant être satisfaite
• 5xx erreurs de serveur - la requête était valide, mais le serveur ne peut pas le remplir pour le moment

Reason-Phrase est une courte description du code d'état. Par exemple, le code 200 a une phrase de raison de OK ; le code 404 a une phrase Not Found . Une liste complète des phrases de motif est disponible dans Paramètres, ci-dessous ou dans la spécification HTTP .

La ligne se termine par un retour chariot - un saut de ligne, généralement représenté par \r\n .

En-têtes supplémentaires

Comme une requête HTTP, une réponse HTTP peut inclure des en-têtes supplémentaires pour modifier ou augmenter la réponse fournie.

Une liste complète des en-têtes disponibles est définie au §6.2 de la spécification . Les en-têtes les plus couramment utilisés sont:

• Server , qui fonctionne comme un en User-Agent tête de requête User-Agent pour le serveur;
• Location utilisé sur les réponses d'état 201 et 3xx pour indiquer un URI à rediriger; et
• ETag , qui est un identificateur unique pour cette version de la ressource renvoyée pour permettre aux clients de mettre en cache la réponse.

Les en-têtes de réponse viennent après la ligne d'état et, comme avec les en- têtes de requête, sont formés comme suit:

Name: Value CRLF

Name fournit le nom de l'en-tête, tel que ETag ou Location , et Value fournit la valeur définie par le serveur pour cet en-tête. La ligne se termine par un CRLF.

Une réponse avec des en-têtes peut ressembler à ceci:

HTTP/1.1 201 Created \r\n
Server: WEBrick/1.3.1 \r\n
Location: http://example.com/files/129742 \r\n

Corps de message

Comme avec les corps de requête , les réponses HTTP peuvent contenir un corps de message. Cela fournit des données supplémentaires que le client traitera. Notamment, 200 réponses OK à une requête GET bien formée doivent toujours fournir un corps de message contenant les données demandées. (S'il n'y en a pas, 204 No Content est une réponse plus appropriée).

Un corps de message est inclus après tous les en-têtes et un double CRLF. Comme pour les requêtes, sa longueur en octets doit être indiquée avec l'en Content-Length tête Content-Length . Une réponse réussie à une demande GET peut donc ressembler à ceci:

HTTP/1.1 200 OK\r\n
Server: WEBrick/1.3.1\r\n
Content-Length: 39\r\n
ETag: 4f7e2ed02b836f60716a7a3227e2b5bda7ee12c53be282a5459d7851c2b4fdfd\r\n
\r\n
Nobody expects the Spanish Inquisition.