03 - El protocolo HTTP

La web funciona sobre HTTP (*HyperText Transfer Protocol*), un protocolo de aplicación cliente-servidor sobre TCP: el cliente envía una petición con formato definido y el servidor responde con una respuesta con otro formato igualmente definido. Todo servidor web de este módulo se dedica, en el fondo, a leer peticiones y escribir respuestas con ese formato.

• Cliente-servidor: el cliente toma siempre la iniciativa; el servidor escucha y responde.
• Sin estado: cada petición es independiente; el servidor no recuerda nada entre peticiones.
• Texto legible en HTTP/1.1: petición y respuesta pueden leerse y escribirse a mano, lo que permite construirlas desde un servidor de sockets.

GET /books/42 HTTP/1.1
Host: localhost:8080
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

• Línea de petición: método, ruta y versión.
• Cabeceras: pares Nombre: valor (una por línea) con información sobre la petición.
• Línea en blanco: separa cabeceras y cuerpo (aquí el cuerpo está vacío, como en todo GET).
• Cuerpo: los datos que el cliente envía; el formato lo anuncia Content-Type.

Un POST que crea un libro incluye cuerpo:

POST /books HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Content-Length: 47

{"title":"Código limpio","author":"R. Martin"}

El método expresa la intención del cliente sobre el recurso que identifica la ruta:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 33

{"id":42,"title":"Código limpio"}

• Línea de estado: versión, código de estado y frase explicativa.
• Cabeceras: Content-Type, Content-Length…
• Cuerpo: los datos, en el formato que anuncia Content-Type.

El código de estado resume el resultado; su primera cifra indica la familia:

curl envía la petición y muestra la respuesta; con -v (*verbose*) muestra ambas tal cual cruzan la red:

$ curl -v http://localhost:8080/books/42
> GET /books/42 HTTP/1.1
> Host: localhost:8080
> Accept: */*
>
< HTTP/1.1 200 OK
< Content-Type: application/json
< Content-Length: 33
<
{"id":42,"title":"Código limpio"}

• Las líneas con > son lo que envía el cliente (la petición).
• Las líneas con < son lo que responde el servidor (la respuesta).