Referencia de Códigos de Estado HTTP

Los códigos de estado HTTP se dividen en cinco clases: 1xx (Informativo) significa que la solicitud fue recibida y el proceso continúa; 2xx (Éxito) indica que la acción fue recibida, comprendida y aceptada con éxito — el más común es 200 OK; 3xx (Redirección) significa que el agente de usuario debe realizar una acción adicional para completar la solicitud, como 301 y 302; 4xx (Error del cliente) indica que la solicitud contiene sintaxis incorrecta o no se puede completar, siendo 404 Not Found el más conocido; y 5xx (Error del servidor) significa que el servidor no pudo procesar una solicitud aparentemente válida, como 500 Internal Server Error.

401 No autorizado significa que la solicitud carece de credenciales de autenticación válidas — el cliente debe autenticarse para obtener la respuesta solicitada. El servidor desafía al cliente a proporcionar autenticación (por ejemplo, a través de una página de inicio de sesión o un token de API). 403 Prohibido significa que el servidor entendió la solicitud pero se niega a autorizarla — la identidad del cliente es conocida pero no tiene permiso para acceder al recurso. A diferencia de 401, volver a autenticarse no ayudará con 403 porque el problema es la autorización, no la autenticación.

Hay muchos códigos de estado HTTP definidos en varios documentos RFC. La IANA (Autoridad de Asignación de Números de Internet) mantiene el registro oficial con más de 60 códigos estandarizados que van desde 100 Continue hasta 511 Network Authentication Required. Sin embargo, solo entre 30 y 40 se encuentran comúnmente en el desarrollo web cotidiano. Esta referencia cubre todos los códigos estándar, incluidos algunos especializados como 418 I'm a Teapot (una RFC de broma de April Fools), 429 Too Many Requests (limitación de velocidad) y 503 Service Unavailable (modo de mantenimiento).

304 No Modificado es un código de redirección que le indica al cliente que el recurso solicitado no ha cambiado desde la última solicitud. En lugar de enviar nuevamente el cuerpo completo de la respuesta, el servidor envía este código para indicar al cliente que use su versión en caché. Esto reduce significativamente el uso de ancho de banda y mejora los tiempos de carga de la página, especialmente para activos estáticos grandes como imágenes, archivos CSS y paquetes JavaScript. Es una parte fundamental del almacenamiento en caché de solicitudes condicionales HTTP y es esencial para la optimización del rendimiento del sitio web.

Los errores 5xx indican fallos del lado del servidor: la solicitud del cliente era válida pero el servidor no pudo cumplirla. Las estrategias comunes de manejo incluyen: implementar lógica de reintento con retroceso exponencial para problemas temporales, mostrar mensajes de error amigables al usuario en lugar de códigos de error sin procesar, registrar información detallada del error en el lado del servidor para depuración, configurar supervisión y alertas para detectar picos de 5xx temprano, y usar balanceadores de carga con verificaciones de salud para desviar el tráfico de servidores no saludables. Para tus propias APIs, asegúrate de devolver códigos 5xx apropiados con detalles claros del error en el cuerpo de la respuesta.