¿Qué son los Códigos de Estado HTTP?

Los códigos de estado HTTP son números de tres dígitos devueltos por un servidor web en respuesta a la solicitud de un cliente. Indican si la solicitud fue exitosa, redirigida o resultó en un error. Comprender estos códigos es esencial para el desarrollo web, diseño de API y depuración.

Categorías de Códigos de Estado

Los códigos de estado HTTP se agrupan en cinco categorías según el primer dígito:

1xx (Informativo)

La solicitud fue recibida y el servidor continúa procesándola

2xx (Éxito)

La solicitud fue recibida, entendida y aceptada exitosamente

3xx (Redirección)

Se necesitan acciones adicionales para completar la solicitud (generalmente una redirección)

4xx (Error del Cliente)

La solicitud contiene un error en el lado del cliente

5xx (Error del Servidor)

El servidor no pudo cumplir una solicitud válida

¿Quién Usa Esta Herramienta?

Esta herramienta de referencia está diseñada para desarrolladores web, desarrolladores de API, probadores de QA y administradores de sistemas que necesitan buscar rápidamente códigos de estado HTTP, entender cuándo usar cada uno y comparar códigos similares.

Cómo Usar Esta Herramienta

Explora por Categoría

Todos los códigos de estado HTTP se muestran en grupos por su categoría (1xx a 5xx). Cada grupo tiene un color distintivo para facilitar la identificación. Simplemente desplázate por la lista para explorar todos los códigos.

Busca un Código

Usa la barra de búsqueda en la parte superior para encontrar un código de estado específico. Puedes buscar por:

Número de código — Escribe "404" para encontrar 404 No Encontrado
Nombre o palabra clave — Escribe "redirección" para encontrar todos los códigos relacionados con redirección
Palabra clave de descripción — Escribe "proxy" para encontrar códigos que mencionen servidores proxy

Filtra por Categoría

Haz clic en las pestañas de categoría (Todos, 1xx, 2xx, 3xx, 4xx, 5xx) para mostrar solo códigos de un grupo específico. Esto es útil cuando conoces el tipo general de respuesta pero no el código exacto.

Ver Detalles

Haz clic en cualquier tarjeta de código de estado para expandirla y ver información detallada incluyendo:

Casos de Uso — Escenarios del mundo real cuando se devuelve este código
Encabezados Comunes — Encabezados de respuesta típicamente asociados con este código
Códigos Relacionados — Códigos similares o frecuentemente confundidos para comparación

Guarda tus Favoritos

Haz clic en el icono de marcador en cualquier código para guardarlo. Los códigos guardados aparecen en la parte superior de la página para acceso rápido. Tus marcadores se guardan en tu navegador y persisten entre sesiones.

Características

Referencia Completa de Códigos de Estado HTTP

Esta herramienta cubre todos los códigos de estado HTTP estándar definidos en RFCs, incluyendo códigos comúnmente utilizados y menos comunes.

200 OK, 301 Movido Permanentemente, 404 No Encontrado
500 Error Interno del Servidor
103 Primeras Pistas, 418 Soy una Tetera
451 No Disponible por Razones Legales

Categorías con Código de Colores

Cada categoría se distingue visualmente con su propio esquema de colores, facilitando la identificación del tipo de respuesta de un vistazo.

Los códigos informativos son azules
Los códigos de éxito son verdes
Los códigos de redirección son ámbar
Los códigos de error del cliente son rojos
Los códigos de error del servidor son púrpura

Casos de Uso Prácticos

Cada código de estado incluye casos de uso del mundo real que explican cuándo y por qué un servidor devuelve ese código específico.

Elige el código de estado correcto para el diseño de API
Comprende respuestas de error al depurar
Aprende mejores prácticas para respuestas HTTP

Comparación de Códigos Relacionados

Los códigos frecuentemente confundidos están vinculados entre sí, permitiéndote navegar rápidamente entre ellos y entender las diferencias.

Compara 401 vs 403
Entiende redirecciones 301 vs 302
Diferencia errores 400 vs 422

Guarda y Acceso Rápido

Marca tus códigos de estado más utilizados para que siempre aparezcan en la parte superior.

Marcadores guardados localmente en tu navegador
No se necesita cuenta
Persisten entre sesiones

Consejo Pro: Usa las categorías con código de colores y la función de guardado juntas para crear tu propia guía de referencia rápida personalizada para los códigos de estado que usas más frecuentemente en tus proyectos.

Preguntas Frecuentes

¿Cuál es la diferencia entre 401 y 403?

401 No Autorizado

Autenticación Requerida

El cliente no ha proporcionado credenciales de autenticación válidas. El cliente debe autenticarse (iniciar sesión) e intentar de nuevo.

El usuario necesita iniciar sesión
Credenciales faltantes o inválidas
Reautenticarse resolverá el problema

403 Prohibido

Permiso Denegado

El cliente está autenticado pero no tiene permiso para acceder al recurso. Reautenticarse no ayudará.

El usuario ha iniciado sesión pero carece de permiso
El acceso está restringido por rol o política
La autenticación no resolverá el problema

¿Cuándo debo usar redirección 301 vs 302?

301 Movido Permanentemente

Redirección Permanente

Úsalo cuando un recurso se ha movido permanentemente a una nueva URL. Los motores de búsqueda actualizarán su índice.

Cambio de dominio o migración
Reestructuración de URL
Reubicación permanente de contenido
El valor SEO se transfiere a la nueva URL

302 Encontrado

Redirección Temporal

Úsalo para redirecciones temporales donde la URL original aún debe usarse en el futuro.

Redirección de página de mantenimiento
Escenarios de prueba A/B
Reubicación temporal de contenido
El valor SEO permanece con la URL original

¿Cuál es la diferencia entre 400 y 422?

400 Solicitud Incorrecta

Solicitud Malformada

La solicitud está malformada — el servidor no puede analizarla.

Sintaxis JSON inválida
Estructura XML malformada
Encabezados requeridos faltantes
Errores a nivel de sintaxis

422 Contenido No Procesable

Error Semántico

La solicitud es sintácticamente correcta pero semánticamente inválida.

JSON válido pero valores de campo inválidos
Fallos de validación de lógica de negocio
Desajustes de tipo de datos
Errores a nivel semántico

¿Qué significa el error 502 Bad Gateway?

Un error 502 Bad Gateway significa que un servidor que actúa como puerta de enlace o proxy recibió una respuesta inválida del servidor ascendente.

Causas Comunes

El proxy inverso (como Nginx) no puede alcanzar la aplicación backend
El servidor backend está caído o sobrecargado
El backend devuelve una respuesta malformada
Problemas de conectividad de red entre proxy y backend
Tiempo de espera agotado esperando la respuesta del servidor ascendente

Consejo de Solución de Problemas: Verifica los registros de tu aplicación backend y asegúrate de que el servidor ascendente esté ejecutándose y sea accesible desde el servidor proxy.

¿Se guardan mis códigos marcados?

Sí. Los códigos marcados se guardan en el almacenamiento local de tu navegador y persistirán entre actualizaciones de página y sesiones del navegador.

No se necesita cuenta ni conexión al servidor
Datos almacenados localmente en tu navegador
Persisten entre sesiones y actualizaciones de página
Privados solo para tu navegador

Nota: Si borras el almacenamiento local de tu navegador o usas un navegador/dispositivo diferente, tus códigos marcados no estarán disponibles. Los marcadores son específicos del dispositivo y navegador.