En este artículo
¿Qué son los códigos de estado HTTP?
Los códigos de estado HTTP son números de tres dígitos devueltos por los servidores web en respuesta a la solicitud de un cliente. Indican si la solicitud fue exitosa, redirigida, resultó en un error o requiere una acción adicional. Cada vez que cargas una página web, tu navegador recibe uno de estos códigos.
Los códigos de estado están definidos por la especificación HTTP (RFC 7231 y RFC relacionadas) y se agrupan en cinco clases según su primer dígito. Comprender estos códigos es esencial para desarrolladores web, diseñadores de API y cualquiera que depure aplicaciones web.
Las cinco categorías de códigos de estado
Los códigos de estado HTTP están organizados en cinco categorías, cada una indica un tipo diferente de respuesta.
- 1xx Informativo — la solicitud fue recibida y el procesamiento continúa (ej.: 100 Continue, 101 Switching Protocols)
- 2xx Éxito — la solicitud fue recibida, entendida y aceptada con éxito (ej.: 200 OK, 201 Created, 204 No Content)
- 3xx Redirección — se necesita una acción adicional para completar la solicitud (ej.: 301 Moved Permanently, 302 Found, 304 Not Modified)
- 4xx Error del cliente — la solicitud contiene sintaxis incorrecta o no puede ser cumplida (ej.: 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found)
- 5xx Error del servidor — el servidor no pudo cumplir una solicitud válida (ej.: 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable)
Pruébalo gratis — sin registro
Buscar códigos de estado →Cuándo usar una referencia de códigos de estado HTTP
Conocer el código de estado correcto para devolver o esperar es crucial para construir servicios web fiables.
- Desarrollo de API — elegir el código de respuesta correcto para cada endpoint (201 para creación, 204 para eliminación, 422 para errores de validación)
- Depuración — diagnosticar problemas cuando las solicitudes fallan (¿es un problema de autenticación 401 o de autorización 403?)
- SEO y monitoreo — rastrear redirecciones 301/302, identificar enlaces rotos 404 y monitorear errores del servidor 5xx
Preguntas frecuentes
¿Cuál es la diferencia entre 401 y 403?
401 Unauthorized significa que el cliente no ha proporcionado credenciales de autenticación válidas — el usuario necesita iniciar sesión o proporcionar una clave API. 403 Forbidden significa que el cliente está autenticado pero no tiene permiso para acceder al recurso. En resumen: 401 = ‘¿quién eres?’, 403 = ‘sé quién eres, pero no puedes acceder a esto.’
¿Cuándo debo usar redirecciones 301 vs 302?
Usa 301 Moved Permanently cuando el recurso se ha movido permanentemente a una nueva URL — los motores de búsqueda actualizarán su índice. Usa 302 Found (o 307 Temporary Redirect) cuando la redirección es temporal y la URL original debe seguir utilizándose en el futuro. Usar el código incorrecto puede perjudicar el SEO.
¿Qué significa un error 500 Internal Server Error?
Un error 500 es un error genérico del lado del servidor que indica que algo salió mal al procesar la solicitud, pero el servidor no puede ser más específico. Las causas comunes incluyen excepciones no controladas en el código de la aplicación, fallos de conexión a la base de datos, servidores mal configurados o problemas de despliegue. Consulta los registros del servidor para obtener los detalles reales del error.