Referencia de Códigos de Estado HTTP

Entendiendo los Códigos de Estado HTTP

Los códigos de estado HTTP son números de tres dígitos que un servidor devuelve en respuesta a cada solicitud HTTP. Son parte de la especificación HTTP y proporcionan una forma estandarizada para que los servidores comuniquen el resultado de una solicitud al cliente. Cuando visita una página web, su navegador envía una solicitud HTTP al servidor, y el servidor responde con un código de estado junto con el contenido solicitado o un mensaje de error. Comprender estos códigos es fundamental para el desarrollo web, el diseño de APIs, la administración de servidores y la depuración de problemas de red.

Los códigos de estado se agrupan en cinco clases según su primer dígito. Cada clase representa un tipo diferente de respuesta. Los códigos 1xx son informativos, indicando que la solicitud fue recibida y el procesamiento continúa. Los códigos 2xx señalan éxito, significando que la solicitud fue recibida, entendida y aceptada. Los códigos 3xx indican redirección, diciéndole al cliente que tome acciones adicionales para completar la solicitud. Los códigos 4xx representan errores del cliente, donde la solicitud contiene sintaxis incorrecta o no puede ser cumplida. Los códigos 5xx indican errores del servidor, donde el servidor no pudo cumplir una solicitud válida.

Las Cinco Categorías de Códigos de Estado

Respuestas Informativas 1xx

Las respuestas informativas indican que el servidor ha recibido la solicitud y continúa procesándola. La más notable es 100 Continue, que le dice al cliente que proceda a enviar el cuerpo de la solicitud después de enviar solo los encabezados. Esto es útil para cargas grandes donde el cliente quiere verificar si el servidor aceptará la solicitud antes de transmitir una carga potencialmente grande. El 103 Early Hints es una adición más reciente que permite al servidor enviar encabezados preliminares antes de la respuesta final, permitiendo al navegador precargar hojas de estilo y scripts mientras el servidor prepara la respuesta principal.

Códigos de Éxito 2xx

Los códigos de éxito confirman que la solicitud fue procesada correctamente. El 200 OK es el más común, devuelto para solicitudes GET exitosas estándar. El 201 Created se usa cuando se ha creado un nuevo recurso, típicamente en respuesta a una solicitud POST. El 204 No Content indica éxito sin un cuerpo de respuesta, comúnmente usado para operaciones DELETE y acciones de API que no necesitan devolver datos. El 206 Partial Content soporta solicitudes de rango, permitiendo a los clientes descargar archivos grandes en fragmentos o reanudar descargas interrumpidas.

Redirección 3xx y Códigos de Error 4xx/5xx

Los códigos de redirección instruyen al cliente a buscar en otro lugar el recurso solicitado. La distinción entre 301 Moved Permanently y 302 Found es crítica para SEO, ya que los motores de búsqueda los tratan de manera diferente al pasar la autoridad de enlace. Los códigos de error del cliente en el rango 4xx cubren todo desde solicitudes malformadas (400) hasta fallos de autenticación (401, 403), recursos faltantes (404) y limitación de velocidad (429). Los códigos de error del servidor en el rango 5xx indican problemas en el lado del servidor, desde fallos generales (500) hasta respuestas de bad gateway (502) y no disponibilidad del servicio (503). Monitorear estos códigos ayuda a los equipos de operaciones a identificar y resolver problemas rápidamente.

Códigos de Estado Comunes en el Desarrollo de APIs

Las APIs RESTful dependen en gran medida de los códigos de estado para comunicar resultados. Una API bien diseñada usa 200 para lecturas exitosas, 201 para creaciones exitosas, 204 para eliminaciones exitosas, 400 para errores de validación, 401 para autenticación faltante, 403 para permisos insuficientes, 404 para recursos que no existen, 409 para conflictos como entradas duplicadas, 422 para solicitudes semánticamente inválidas y 429 para solicitudes con límite de velocidad. El uso consistente de códigos de estado hace que las APIs sean predecibles y más fáciles de integrar para los consumidores.

Preguntas Frecuentes

¿Qué son los códigos de estado HTTP?

Números de tres dígitos devueltos por servidores web que indican el resultado de una solicitud. Se agrupan en cinco clases: 1xx Informativo, 2xx Éxito, 3xx Redirección, 4xx Error del Cliente y 5xx Error del Servidor.

¿Qué significan los códigos de estado 4xx?

Los códigos 4xx indican errores del cliente. La solicitud estaba malformada, no autorizada o apuntaba a un recurso faltante. Ejemplos comunes incluyen 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found y 429 Too Many Requests.

¿Cuál es la diferencia entre redirecciones 301 y 302?

301 es una redirección permanente que indica a navegadores y motores de búsqueda que actualicen sus URLs. 302 es una redirección temporal donde la URL original debe seguir usándose para futuras solicitudes. 301 transfiere la autoridad SEO de enlace; 302 no.

¿Qué es el código de estado HTTP 418?

Una broma del Día de los Inocentes del RFC 2324 que define el Hyper Text Coffee Pot Control Protocol. Una tetera devuelve 418 cuando se le pide preparar café. A pesar de ser humorístico, ha sido ampliamente implementado como Easter egg.

¿Cuándo debería usar una respuesta 204 No Content?

Use 204 para solicitudes exitosas que no necesitan un cuerpo de respuesta, como operaciones DELETE, actualizaciones exitosas donde el cliente ya tiene los datos y acciones de API de tipo disparar y olvidar.