Lista de códigos de estado HTTP rápida y con buscador
Cada vez que un navegador, una aplicación móvil o el rastreador de un motor de búsqueda realiza una solicitud a un servidor web, el servidor responde con un número de tres dígitos. Estos códigos de estado HTTP le indican al cliente exactamente qué ocurrió: si la solicitud se completó con éxito, si falló, si requiere autenticación o si debe redirigirse a otro lugar.
Esta herramienta ofrece un diccionario completo y con buscador de los códigos de respuesta HTTP estándar, basado en las especificaciones RFC oficiales. Como toda la lista se carga y filtra de forma local en tu navegador, la búsqueda es totalmente instantánea. No necesitas esperar a que se recargue la página para consultar la diferencia entre un 301 y un 302, o para averiguar qué significa un error 422.
Las cinco clases de códigos de respuesta HTTP
Los códigos HTTP se agrupan en cinco clases distintas, definidas por su primer dígito. Entender estas categorías es la forma más rápida de diagnosticar problemas de tráfico web:
1xx (Informativos)
Estos códigos indican que el servidor ha recibido la solicitud y continúa el proceso. Son respuestas temporales y el cliente debe esperar una respuesta final. Por ejemplo, 100 Continue le dice al cliente que siga adelante y envíe el cuerpo de la solicitud.
2xx (Éxito)
Un código 2xx significa que la solicitud del cliente fue recibida, entendida y aceptada correctamente. El más común es 200 OK, que es la respuesta estándar para una solicitud HTTP exitosa. Al crear un nuevo registro a través de una API, es posible que veas un 201 Created.
3xx (Redirección)
Estos códigos le indican al cliente que se necesita una acción adicional para completar la solicitud. Esto suele significar que el recurso solicitado se ha movido. Un 301 Moved Permanently indica a los motores de búsqueda que actualicen sus enlaces, mientras que un 302 Found indica un traslado temporal.
4xx (Error del cliente)
Los códigos de error HTTP en el rango 4xx significan que el problema está del lado del cliente. La solicitud puede contener una sintaxis incorrecta, carecer de la autenticación adecuada o pedir un recurso que no existe. Estos errores son comunes cuando los usuarios escriben mal las URL o cuando las integraciones de API envían datos con un formato incorrecto.
5xx (Error del servidor)
Un código 5xx significa que el servidor no pudo cumplir con una solicitud válida. El cliente hizo todo bien, pero el servidor encontró un problema interno, falló o está sobrecargado en este momento.
Códigos de error HTTP comunes que debes conocer
Aunque existen decenas de códigos, unos pocos representan la gran mayoría de los errores que encontrarás como desarrollador o webmaster:
El código de estado 404 (No encontrado)
Quizás el error más famoso de internet, el código 404 significa que el servidor no pudo encontrar el recurso solicitado. Para los propietarios de sitios web, monitorear los errores 404 es crucial para el SEO, ya que los enlaces rotos frustran a los usuarios y desperdician el presupuesto de rastreo (crawl budget).
400 Bad Request
El servidor no puede procesar la solicitud debido a un error del cliente, como una sintaxis malformada o un enrutamiento no válido. Las API suelen devolver este error cuando falta un parámetro obligatorio.
401 Unauthorized y 403 Forbidden
Ambos están relacionados con el acceso. Un 401 Unauthorized significa que el cliente debe autenticarse para obtener la respuesta solicitada (por ejemplo, falta una clave de API). Un 403 Forbidden significa que se conoce la identidad del cliente, pero este no tiene los permisos necesarios para acceder al recurso.
500 Internal Server Error
Es un error genérico para los fallos del lado del servidor. Significa que el servidor encontró una condición inesperada que le impidió completar la solicitud. Cuando ves un error 500, normalmente debes revisar los registros (logs) de la aplicación del servidor para encontrar la causa raíz.
502 Bad Gateway y 503 Service Unavailable
Un 502 Bad Gateway ocurre cuando un servidor que actúa como proxy (como Nginx o un balanceador de carga) recibe una respuesta no válida del servidor de origen. Un 503 Service Unavailable significa que el servidor no puede procesar la solicitud en este momento, generalmente porque está sobrecargado o en mantenimiento.
Mejores prácticas para el desarrollo de APIs
Al crear una API REST, devolver los códigos de estado HTTP correctos es esencial para ofrecer una buena experiencia al desarrollador. Devolver un 200 OK cuando en realidad ocurrió un error (práctica a menudo conocida como "enmascarar" o "silenciar" errores) obliga a los clientes a analizar manualmente el cuerpo de la respuesta para saber si su solicitud realmente tuvo éxito.
Usa esta referencia para elegir el código semánticamente más correcto. Por ejemplo, usa 429 Too Many Requests cuando un usuario alcanza el límite de solicitudes, o 422 Unprocessable Content cuando el payload JSON es válido pero no supera la validación de la lógica de negocio.
Si estás investigando problemas de enrutamiento del servidor, nuestra herramienta de Búsqueda DNS te resultará útil para verificar los registros del dominio, así como el Analizador de User-Agent para entender qué clientes hacen peticiones a tu servidor. Si intentas gestionar cómo los motores de búsqueda rastrean tu sitio para evitar errores 404, prueba el Generador de Robots.txt.