# HTTP

## Qué es

HTTP, Hypertext Transfer Protocol, es el conjunto de reglas que siguen un navegador, una aplicación o un script para pedir algo a un servidor y recibir una respuesta; cuando la conversación ocurre dentro de una conexión TLS cifrada, el mismo protocolo se llama HTTPS. Cada intercambio tiene dos partes. El cliente envía una solicitud: un método como `GET` o `POST`, el destino que quiere, una lista de campos de cabecera y, a veces, un cuerpo. El servidor responde con un código de estado de tres dígitos, sus propios campos y, normalmente, un cuerpo. Cargar una página, obtener una imagen y llamar de un programa a otro repiten el mismo intercambio.

```http
GET /pricing/ HTTP/1.1
Host: example.com
Accept: text/html

HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Cache-Control: max-age=600
```

La especificación lo define como un protocolo sin estado. Cada solicitud debe llevar todo lo que necesita el servidor para entenderla y el protocolo no guarda memoria de un intercambio al siguiente. Los inicios de sesión, los carritos y las sesiones se construyen encima, normalmente con cookies: un campo de cabecera que el servidor fija una vez y el cliente devuelve en cada solicitud posterior.

El vocabulario es pequeño y preciso. `GET` y `HEAD` son seguros: piden una representación y se espera que no cambien nada. `PUT` y `DELETE` son idempotentes: enviar dos veces lo mismo deja al servidor como si se hubiera enviado una. `POST` no promete ninguna de las dos cosas. Los códigos de estado se agrupan por su primer dígito: 2xx para éxito, 3xx para redirección, 4xx para un problema en la solicitud y 5xx para uno en el servidor; así, incluso ante un código desconocido, el cliente sabe aproximadamente qué ocurrió.

El significado se ha mantenido aunque el formato en la red se ha sustituido dos veces. HTTP/1.1 escribe mensajes como líneas de texto sobre una conexión TCP y cada conexión devuelve sus respuestas de una en una, en orden. HTTP/2 conserva métodos y campos, pero los organiza en tramas binarias e intercala muchas solicitudes en una conexión. HTTP/3 transporta la misma semántica sobre QUIC, un transporte basado en UDP que evita el bloqueo de cabecera de línea de TCP en la capa de transporte entre flujos independientes. Desde 2022, la IETF publica la semántica en un documento y el formato de cada versión en otro: por eso «qué significa 404» y «cómo se disponen los bytes» tienen ahora respuestas separadas.

HTTP frente a HTTPS no es, por tanto, una competición entre dos protocolos: HTTPS es HTTP con TLS por debajo, que cifra el intercambio y acredita el nombre del servidor. WebSocket empieza como una solicitud HTTP y después convierte la conexión en un canal bidireccional; gRPC es una convención para llamar a funciones remotas que funciona sobre HTTP/2.

## Por qué importa

Casi todo sistema que habla con otro por Internet ya usa HTTP, así que la decisión importante rara vez es si usarlo. Es si aprovechar lo que define o tratarlo como una tubería y reconstruir el resto encima.

Usarlo plenamente compensa porque una larga cadena de software ya entiende el vocabulario. Una biblioteca cliente puede reintentar un `GET` que superó su tiempo de espera; no debe reintentar un `POST`, y tampoco debe hacerlo ningún proxy intermedio. Una caché puede conservar diez minutos una respuesta con `max-age=600` y servirla al siguiente lector sin preguntar al servidor. La monitorización cuenta las respuestas 5xx como errores sin que se le indique. Una API que envía todo por `POST` a una dirección y comunica fallos dentro de una respuesta 200 renuncia a todo ello; cada cliente debe aprender entonces sus reglas privadas.

El modelo tiene límites. Solicitud y respuesta sirven a un cliente que sabe qué quiere; encajan mucho peor con un servidor que tiene novedades que enviar, por lo que las actualizaciones en vivo suelen viajar por WebSocket, eventos enviados por el servidor o sondeo.

HTTP en claro sobre la Internet pública es otra cuestión con respuesta breve. Los navegadores lo marcan como inseguro, cualquiera en la ruta puede leerlo y alterarlo y los certificados no cuestan nada: el tráfico público debe ir por HTTPS. Elegir entre HTTP/1.1, HTTP/2 y HTTP/3 es, en gran medida, un ajuste en el servidor o en la infraestructura perimetral que tiene delante; el código de la aplicación permanece igual porque el significado de cada solicitud no cambia.

## Cómo se aplica en la práctica

El caso más claro de este sitio es una API trasladada a un framework construido sobre la propia forma de HTTP. [La API HTTP pasó de Fiber a Huma v2](/es/portfolio/migrated-the-api-to-huma-v2-at-100-parity/), que funciona sobre Fiber: cada endpoint se declara con estructuras de entrada y salida y la validación nace de los tipos, no de comprobaciones escritas a mano. Las mismas declaraciones producen una descripción OpenAPI y un control de CI compara las rutas que registra el servidor con las que anuncia la descripción. Con 649 rutas y 760 operaciones, la paridad es del 100 % y se mantiene porque una ruta sin describir hace fallar el proceso de construcción. Exactamente dos endpoints permanecieron en Fiber directo: los de WebSocket, donde no encaja el modelo de solicitud y respuesta de Huma.

El propio sitio usa negociación de contenido. Cada página se publica en HTML y Markdown; una forma de obtener Markdown es [enviar una solicitud con `Accept: text/markdown` y dejar elegir al servidor](/es/cli/). La dirección onion de esa página es `http://` deliberadamente: como codifica la clave pública del servicio, Tor ya ha autenticado y cifrado el circuito cuando viaja la primera solicitud HTTP.

HTTP también aparece como herramienta en el código de infraestructura. Al aprovisionar un segundo servidor, [los cortafuegos de ambos proveedores se escribieron directamente contra sus API REST](/es/portfolio/provisioned-a-second-server-from-code/) mediante una tarea HTTP genérica en lugar de una colección del proveedor. Eso eliminó una dependencia y su divergencia de versiones, a cambio de escribir a mano la forma de cada solicitud. La página señala otro coste: la tarea HTTP genérica no declara compatibilidad con el modo de comprobación, por lo que una ejecución de prueba del play que crea la máquina omite todas sus tareas y el ensayo se ejecuta contra el play del cortafuegos.

## Dónde surgen los problemas

La mayoría de los errores HTTP nacen de usar una palabra del vocabulario con un significado distinto del que entiende el resto de la cadena.

### Un error que llega como éxito

Una API responde 200 y pone `"error": "card declined"` en el cuerpo. Las cachés pueden almacenarlo, los paneles cuentan un éxito y la lógica de reintento del cliente nunca se activa. Envíe el estado adecuado, 4xx o 5xx, y describa el problema en el cuerpo; el RFC 9457 define un formato JSON servido como `application/problem+json`.

### Un enlace que elimina cosas

Una solicitud `GET` cambia el estado, por ejemplo un enlace para darse de baja o eliminar algo en un correo. Rastreadores, vistas previas de enlaces en aplicaciones de chat, analizadores de seguridad y precarga del navegador siguen enlaces por sí solos y cualquiera puede activarlo. Todo lo que cambia datos debe ir tras `POST`, `PUT` o `DELETE`, con una página de confirmación si el enlace debe existir.

### Un pago cobrado dos veces

El cliente envía un `POST`, la conexión cae antes de llegar la respuesta y el cliente vuelve a intentarlo. El servidor ya había procesado el primero. HTTP no permite al cliente distinguir esos casos, así que debe hacerlo la API: aceptar una clave de idempotencia en una cabecera y devolver el resultado almacenado al repetir la clave, o dejar que el cliente elija el identificador del recurso nuevo y lo cree con `PUT`.

### Un formulario que se convierte en GET

Un servidor responde a un `POST` con 301 o 302 para enviarlo a otro lugar. Por razones históricas, la especificación permite a los agentes de usuario cambiar el método a `GET` con esos dos códigos, y muchos lo hacen, de modo que se descarta el cuerpo por el camino. Cuando deba conservarse el método durante la redirección, use 307 o 308.

### La variante equivocada de una caché

Una URL sirve HTML o Markdown, inglés o danés, según los campos de cabecera de la solicitud. Una caché sin instrucciones conserva la primera variante que ve y la entrega al siguiente lector. La respuesta debe nombrar los campos de los que depende, por ejemplo `Vary: Accept`, para que la caché guarde una copia por variante y no por URL.

## Lecturas adicionales

- [RFC 9110: semántica HTTP](https://www.rfc-editor.org/rfc/rfc9110) — Métodos, códigos de estado y campos de cabecera definidos una sola vez para todas las versiones.
- [RFC 9111: caché HTTP](https://www.rfc-editor.org/rfc/rfc9111) — Cuándo puede reutilizarse una respuesta almacenada y qué le indica `Cache-Control` a una caché.
- [RFC 9112: HTTP/1.1](https://www.rfc-editor.org/rfc/rfc9112) — Formato de texto en la red, gestión de conexiones y delimitación de mensajes.
- [RFC 9113: HTTP/2](https://www.rfc-editor.org/rfc/rfc9113) — Tramas binarias y muchos flujos sobre una conexión.
- [RFC 9114: HTTP/3](https://www.rfc-editor.org/rfc/rfc9114) — La misma semántica trasladada a flujos QUIC.
- [RFC 9457: detalles de problemas para API HTTP](https://www.rfc-editor.org/rfc/rfc9457)
  — Un cuerpo JSON estándar para describir qué falló.

<https://engineer.company/es/glossary/http/>
