Referencia de códigos de estado HTTP
Los códigos de estado HTTP son los números de tres dígitos que un servidor web devuelve para indicarle al cliente si una solicitud tuvo éxito, fue redirigida o falló. Esta referencia te permite consultar y buscar cada código estándar del 1xx al 5xx, con una descripción en lenguaje claro, casos de uso reales, cabeceras comunes y códigos relacionados para cada uno.
Está pensada para desarrolladores web, desarrolladores de API, testers de QA y administradores de sistemas que necesitan buscar un código rápido, entender exactamente cuándo devolverlo y comparar códigos fáciles de confundir, como 401 frente a 403 o 301 frente a 302.
Cómo usar esta referencia
Busca un código
Escribe en el cuadro de búsqueda para filtrar al instante. Busca por número de código (404), por nombre (redirect) o por una palabra clave de la descripción (proxy) para encontrar todos los códigos que coincidan.
Filtra por categoría
Toca las pestañas — Todos, 1xx, 2xx, 3xx, 4xx o 5xx — para mostrar un solo grupo cuando conoces el tipo de respuesta pero no el código exacto.
Abre los detalles
Toca cualquier tarjeta de código de estado para desplegarla y ver sus casos de uso, las cabeceras de respuesta comunes y los códigos relacionados. Toca un código relacionado para saltar directamente a él.
Fija tus favoritos
Toca el icono de marcador en cualquier código para fijarlo en la parte superior de la página. Los códigos fijados se guardan en tu navegador, por lo que permanecen entre sesiones. Usa Copiar para obtener el código y el nombre con un clic.
Funciones
Lista completa de códigos de estado
Consulta todos los códigos de estado HTTP estándar, organizados en las cinco categorías del 1xx al 5xx, incluidos los que rara vez se ven, como 103, 418 y 451.
Categorías con colores
Cada grupo tiene su propio color — Informativo, Éxito, Redirección, Error del cliente y Error del servidor — para que reconozcas el tipo de respuesta de un vistazo.
Búsqueda instantánea
Filtra mientras escribes por número de código, nombre del estado o cualquier palabra clave de la descripción para encontrar el código correcto en segundos.
Pestañas de filtro por categoría
Cambia entre las pestañas Todos, 1xx, 2xx, 3xx, 4xx y 5xx para acotar la lista a una sola categoría de respuesta.
Casos de uso prácticos
Despliega cualquier código para ver situaciones reales que explican cuándo y por qué un servidor lo devuelve, lo que te ayuda a elegir el código correcto para tu API.
Cabeceras de respuesta comunes
Cada código indica las cabeceras de respuesta que suelen enviarse con él, como Location, Retry-After o WWW-Authenticate.
Navegación de códigos relacionados
Los códigos que suelen confundirse están enlazados entre sí: salta de 401 a 403 o de 301 a 302 para comparar sus diferencias al instante.
Fija para acceder rápido
Marca los códigos que más usas para que siempre queden en la parte superior de la página. Los fijados se guardan localmente, sin necesidad de cuenta.
Copiar al portapapeles
Copia un código de estado y su nombre juntos con un clic, listos para pegar en tu código, tu documentación o un informe de error.
Preguntas frecuentes
¿Qué significa el código de estado HTTP 200?
200 OK es la respuesta de éxito estándar. Significa que la solicitud se recibió, se entendió y se completó, y que el cuerpo de la respuesta contiene el recurso solicitado. Lo verás en un GET exitoso, en un POST que devuelve datos o en cualquier llamada de API que devuelve el recurso que pediste.
¿Cuál es la diferencia entre los errores 4xx y 5xx?
Los códigos 4xx son errores del cliente: la propia solicitud tiene un problema, como una URL incorrecta (404), falta de autenticación (401) o datos mal formados (400), por lo que repetir la misma solicitud sin cambios volverá a fallar. Los códigos 5xx son errores del servidor: la solicitud era válida, pero el servidor no pudo completarla, como en 500 Internal Server Error o 503 Service Unavailable. Con los 5xx, la solución suele estar del lado del servidor.
¿Qué significan los códigos de estado 404, 500 o 403?
404 Not Found significa que el servidor no puede encontrar el recurso solicitado: la URL no se reconoce. 500 Internal Server Error es un mensaje genérico para una condición inesperada en el servidor, como una excepción no controlada. 403 Forbidden significa que el servidor entendió la solicitud pero se niega a autorizarla; a diferencia de 401, volver a autenticarse no ayudará, porque el problema son los permisos, no la identidad.
¿Cuál es la diferencia entre 401 y 403?
401 Unauthorized significa que no se proporcionaron credenciales de autenticación válidas: el cliente debe iniciar sesión y reintentar. 403 Forbidden significa que el cliente está autenticado pero no tiene permiso para acceder al recurso, por lo que volver a autenticarse no cambiará el resultado.
¿Cuándo debo usar una redirección 301 o 302?
Usa 301 Moved Permanently cuando un recurso se haya movido de forma permanente a una nueva URL, como un cambio de dominio o una reestructuración de URL: los motores de búsqueda actualizarán su índice a la nueva dirección. Usa 302 Found para una redirección temporal en la que la URL original deba seguir usándose en el futuro, como una página de mantenimiento o una prueba A/B.
¿Qué significa 502 Bad Gateway?
502 Bad Gateway significa que un servidor que actúa como puerta de enlace o proxy recibió una respuesta no válida del servidor ascendente. Suele ocurrir cuando un proxy inverso como Nginx no puede alcanzar la aplicación de backend, o cuando el backend devuelve una respuesta con formato incorrecto.
¿Se guardan los códigos que fijo?
Sí. Los códigos fijados se guardan en el almacenamiento local de tu navegador y persisten entre recargas de página y sesiones del navegador. No se necesita ninguna cuenta ni conexión a un servidor; y como los datos son locales, tus códigos fijados quedan privados en tu dispositivo.
Aún no hay comentarios. ¡Sé el primero en comentar!