HTTP
HTTP-reacties

parameters

Standaard antwoordformaat

Wanneer een HTTP-server een goed gevormd HTTP-verzoek ontvangt, moet deze de informatie in dat verzoek verwerken en een reactie terugsturen naar de client. Een eenvoudige HTTP 1.1-reactie kan er als volgt uitzien, meestal gevolgd door een aantal koptekstvelden en mogelijk een antwoordtekst:

HTTP/1.1 200 OK \r\n

HTTP/1.1 404 Not Found \r\n

HTTP/1.1 503 Service Unavailable \r\n

Een eenvoudige HTTP 1.1-reactie heeft dit formaat:

HTTP-Version Status-Code Reason-Phrase CRLF

Net als bij een aanvraag geeft HTTP-Version de gebruikte versie van het HTTP-protocol aan; voor HTTP 1.1 moet dit altijd de string HTTP/1.1 .

Status-Code is een driecijferige code die de status van het verzoek van de klant aangeeft. Het eerste cijfer van deze code is de statusklasse , waarmee de statuscode in een van de 5 antwoordcategorieën wordt geplaatst ^[1] :

• 1xx Informatief - de server heeft het verzoek ontvangen en de verwerking gaat door
• 2xx Succes - de server heeft aanvaard en verwerkt het verzoek
• 3xx omleiding - verdere actie van de klant is nodig om het verzoek te voltooien
• 4xx clientfouten - de client heeft een verzoek verzonden dat onjuist was of waaraan niet kan worden voldaan
• 5xx Server Fouten - het verzoek geldig was, maar de server kan niet voldoen aan het op dit moment

Reason-Phrase is een korte beschrijving van de statuscode. Code 200 heeft bijvoorbeeld een redenzin van OK ; code 404 heeft een zin Not Found . Een volledige lijst met redenzinnen is beschikbaar in Parameters, hieronder of in de HTTP-specificatie .

De regel eindigt met een regelterugloop - regelinvoerpaar, meestal voorgesteld door \r\n .

Aanvullende kopteksten

Net als een HTTP-verzoek, kan een HTTP-antwoord extra headers bevatten om het antwoord te wijzigen of aan te vullen.

Een volledige lijst met beschikbare headers is gedefinieerd in §6.2 van de specificatie . De meest gebruikte headers zijn:

• Server , die functioneert als een User-Agent aanvraagheader voor de server;
• Location , die wordt gebruikt bij 201 en 3xx statusreacties om een URI aan te geven waarnaar moet worden omgeleid; en
• ETag , een unieke identificatie voor deze versie van de geretourneerde bron om clients in staat te stellen het antwoord te cachen.

Reactiekopteksten komen na de statusregel en worden net als bij verzoekkopteksten als volgt gevormd:

Name: Value CRLF

Name geeft de kopnaam, zoals ETag of Location , en Value geeft de waarde die de server voor die koptekst instelt. De regel eindigt met een CRLF.

Een reactie met headers kan er zo uitzien:

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

Message Bodies

Net als bij aanvraaglichamen kunnen HTTP-antwoorden een berichtlichaam bevatten. Dit levert extra gegevens op die de client zal verwerken. Met name moeten 200 OK-antwoorden op een goed gevormd GET-verzoek altijd een berichttekst bevatten met de gevraagde gegevens. (Als er geen is, is 204 Geen inhoud een geschikter antwoord).

Een berichttekst is opgenomen na alle headers en een dubbele CRLF. Wat aanvragen betreft, moet de lengte in bytes worden opgegeven met de kop Content-Length . Een succesvol antwoord op een GET-verzoek kan er daarom als volgt uitzien:

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.