¿Qué son los Códigos de Estado HTTP?
Los códigos de estado HTTP son números de tres dígitos que un servidor web devuelve en respuesta a la solicitud de un cliente. Comunican si una petición fue exitosa, falló o requiere alguna acción adicional.
Se agrupan en cinco categorías: 1xx (Informativos), 2xx (Éxito), 3xx (Redirección), 4xx (Error del Cliente) y 5xx (Error del Servidor). Cada categoría cumple una función específica dentro del protocolo HTTP.
Comprender estos códigos es fundamental para desarrolladores web, ingenieros DevOps y profesionales de SEO. Un 301 transfiere la autoridad de enlace para SEO, un 429 indica limitación de velocidad, y un 503 le dice a los buscadores que reintenten más tarde. Esta herramienta te permite consultar cualquier código y entender su significado en contexto.
Cómo Usar
- 1Navega por todos los códigos o usa las pestañas de categoría para filtrar por 1xx, 2xx, 3xx, 4xx o 5xx.
- 2Escribe un número de código, nombre o palabra clave en el buscador para filtrar al instante.
- 3Haz clic en cualquier tarjeta de código para expandir y ver los casos de uso comunes.
- 4Usa las descripciones de categoría para entender qué representa cada grupo.
- 5Consulta esta página cada vez que encuentres un código de respuesta HTTP desconocido.
Cuándo lo Necesitas
Depurando respuestas de API
Cuando tu API devuelve un código inesperado, consúltalo aquí para entender qué comunica el servidor y cómo manejarlo en tu código cliente.
Configurando redirecciones para SEO
Elige entre 301 (permanente) y 302 (temporal) según si quieres que los buscadores transfieran la autoridad de página a la nueva URL.
Implementando manejo de errores
Decide qué códigos HTTP debe devolver tu API para distintas condiciones de error: 400 para entrada inválida, 401 para autenticación faltante, 403 para acceso prohibido, 422 para fallos de validación.
Leyendo logs del servidor
Al monitorear logs de acceso o errores, decodifica rápidamente los códigos para identificar patrones como limitación de bots (429) o rutas internas rotas (500).
Consejos
Usa códigos específicos en lugar de genéricos
Devuelve 404 para recursos inexistentes, 409 para conflictos y 422 para errores de validación, en vez de abusar del 400 Bad Request para todo.
Incluye cuerpos de error útiles
El código de estado indica la categoría del problema; el cuerpo de la respuesta debe explicar el error específico y cómo solucionarlo.
Respeta la semántica para SEO
Usa 301 para movimientos permanentes, 410 para contenido eliminado intencionalmente, y 503 con cabecera Retry-After durante mantenimiento.
Maneja el 429 con retroceso exponencial
Cuando recibas respuestas de límite de velocidad, aplica retroceso exponencial en lugar de reintentar de inmediato para evitar ser bloqueado.
Ejemplos
Respuesta exitosa de API
Una petición GET que devuelve datos normalmente.
Input
GET /api/usuarios/123Output
200 OK — La solicitud fue exitosa y el servidor devolvió los datos del usuario.Recurso no encontrado
Solicitando una página que no existe.
Input
GET /api/usuarios/99999Output
404 Not Found — El servidor no puede encontrar el recurso solicitado.Límite de velocidad excedido
Demasiadas solicitudes en un período corto.
Input
GET /api/buscar (solicitud número 100 en 1 minuto)Output
429 Too Many Requests — Espera y reintenta con retroceso exponencial.Limitaciones
- Esta referencia cubre códigos estándar HTTP/1.1 y extensiones comunes. No incluye códigos propietarios o específicos de aplicación (p. ej., Cloudflare 520-527).
- La semántica de los códigos puede variar entre implementaciones: algunas APIs usan códigos de forma no convencional.
- Esta herramienta es una referencia de consulta y no puede diagnosticar por qué tu servidor específico devuelve un código determinado.
Características
- Referencia completa de más de 50 códigos de estado HTTP estándar
- Búsqueda instantánea por número de código, nombre o palabra clave
- Filtrado por categoría: Informativos, Éxito, Redirección, Error del Cliente, Error del Servidor
- Tarjetas expandibles con casos de uso reales para cada código
- Categorías codificadas por color para identificación visual rápida
- Códigos relevantes para SEO destacados con implicaciones de redirección y rastreo
- 100% del lado del cliente — sin carga de datos, funciona sin conexión una vez cargado
Preguntas Frecuentes
¿Cuál es la diferencia entre 401 y 403?
401 Unauthorized significa que la solicitud carece de credenciales de autenticación válidas — el cliente debe autenticarse y reintentar. 403 Forbidden significa que el servidor entendió la solicitud pero se niega a autorizarla, incluso con credenciales válidas. La autenticación no ayuda con un 403.
¿Debo usar 301 o 302 para redirecciones?
Usa 301 Moved Permanently cuando la URL ha cambiado definitivamente y quieres que los buscadores transfieran el valor SEO. Usa 302 Found para redirecciones temporales donde la URL original debe seguir siendo la canónica.
¿Qué significa 418 I'm a Teapot?
Es un código de estado HTTP real del RFC 2324 (Hyper Text Coffee Pot Control Protocol), originalmente una broma del Día de los Inocentes. Algunas APIs lo usan como easter egg o para indicar que el servidor no procesará ciertas solicitudes intencionalmente.
¿Cuándo debo devolver 422 en vez de 400?
400 Bad Request es para solicitudes mal formadas (sintaxis JSON inválida, cabeceras faltantes). 422 Unprocessable Entity es para solicitudes bien formadas con contenido semánticamente inválido (JSON válido pero un campo no pasa la validación).
¿Cómo afectan los códigos de estado al SEO?
301 transfiere aproximadamente el 95% de la autoridad de enlace a la nueva URL. Las páginas 404 eventualmente se eliminan del índice. 503 con Retry-After indica a los rastreadores que vuelvan más tarde sin penalización. 410 les dice que el contenido se eliminó intencionalmente.
Last reviewed:
Tu Privacidad
Esta es una herramienta de referencia pura. No se envía ningún dato a ningún servidor. Toda la búsqueda y filtrado se realiza completamente en tu navegador.
Consejos y Flujos Relacionados
- ¿Necesitas codificar caracteres especiales en parámetros de URL?Codificador URL.
- ¿Quieres formatear cuerpos de respuesta de API para depurar?Formateador JSON.
- ¿Probando patrones regex para analizar logs?Probador de Regex.