Buscador de Códigos de Estado HTTP
Directorio interactivo y guia de resolucion de problemas para codigos de estado HTTP segun RFC 9110, cabeceras y errores de servidores proxy.
Acerca de Buscador de Códigos de Estado HTTP
Los códigos de estado HTTP son números enteros normalizados de tres dígitos emitidos por servidores web en respuesta a las solicitudes de los clientes. Regulados por los estándares IETF RFC 9110, RFC 6585 y RFC 4918, indican si una operación se ha completado correctamente, si requiere redirección o si se han producido errores en el cliente o en el servidor.
Esta estación de trabajo proporciona un catálogo de referencia interactivo con más de 60 códigos de estado estandarizados y específicos de la industria pertenecientes a las clases 1xx Informativo, 2xx Éxito, 3xx Redirección, 4xx Error del cliente, 5xx Error del servidor, además de códigos de proxy de Cloudflare y Nginx.
Más allá de simples definiciones, este motor incluye reglas de almacenamiento en caché según RFC 9111, encabezados de respuesta esperados (Location, Retry-After, WWW-Authenticate), diagnóstico del origen del problema y listas de comprobación para depuración de incidencias.
Para la depuración de redes, examine los encabezados del servidor con el inspector de encabezados HTTP o genere código para llamadas de API con el conversor de cURL a Fetch.
Especificaciones de ingeniería y detalles de ejecución
Cubre códigos de estado correspondientes a RFC 9110 (Semántica HTTP), RFC 6585, RFC 4918 (WebDAV), RFC 8297 y RFC 8470.
Proporciona clasificaciones de caché HTTP según RFC 9111: almacenable en caché por defecto, heurística o no almacenable en caché.
Incluye códigos específicos de proxy perimetral: Cloudflare (del 520 al 526) y Nginx 499.
El motor de búsqueda en memoria localiza números de código, nombres, descripciones y encabezados sin ninguna latencia de red.
Los generadores de exportación en el lado del cliente generan esquemas JSON válidos según RFC y tablas CSV formateadas.
Privacidad de datos y aislamiento en memoria
Todas las búsquedas, filtros y análisis de datos se ejecutan íntegramente dentro de la memoria del navegador del cliente.
No se transmite ninguna consulta ni parámetro de diagnóstico a través de la red ni se registran en servidores externos.
Casos de uso comunes en producción
- Ingenieros de backend y API que eligen los códigos de respuesta semánticos adecuados para servicios web RESTful.
- Ingenieros de fiabilidad de sitios (SRE) y equipos de DevOps que diagnostican caídas en proxies inversos (502 Bad Gateway, 504 Gateway Timeout).
- Desarrolladores de frontend que analizan solicitudes fetch y axios fallidas en la consola de red del navegador.
- Especialistas en SEO que comparan redirecciones permanentes 301 frente a redirecciones temporales 302 y directivas 410 Gone.
- Auditores de seguridad que investigan los límites de permisos entre 401 Unauthorized y 403 Forbidden.
Casos extremos y límites operativos
- 401 Unauthorized frente a 403 Forbidden: 401 indica credenciales ausentes o no válidas (se requiere inicio de sesión). 403 significa que la autenticación fue satisfactoria, pero el usuario no tiene permisos suficientes para acceder al recurso.
- 301 Moved Permanently frente a 308 Permanent Redirect: Históricamente, los navegadores transformaban las solicitudes POST 301 en peticiones GET. El RFC 9110 define 308 para garantizar la conservación estricta del método HTTP y del cuerpo del mensaje.
- 400 Bad Request frente a 422 Unprocessable Content: 400 señala un error de sintaxis estructural. 422 indica que la sintaxis JSON es correcta, pero los valores no superan las reglas de validación del dominio.
- 502 Bad Gateway frente a 504 Gateway Timeout: 502 ocurre cuando un servidor de origen responde con datos no válidos o cierra el socket TCP de golpe. 504 se produce cuando el servidor de origen no responde antes de que expire el tiempo de espera.
Preguntas Frecuentes
¿Cuál es la diferencia fundamental entre 401 Unauthorized y 403 Forbidden?
401 Unauthorized significa que la autenticación falta o no es válida, exigiendo credenciales correctas. 403 Forbidden significa que el servidor reconoció la identidad del cliente, pero deniega el acceso debido a permisos o privilegios insuficientes.
¿En qué se diferencian las redirecciones 301 Moved Permanently y 302 Found respecto a SEO y almacenamiento en caché?
Una respuesta 301 notifica a los motores de búsqueda y navegadores que el recurso se ha trasladado de forma definitiva, transfiriendo la autoridad SEO y guardándose de forma agresiva en caché. Una respuesta 302 indica un desvío puramente temporal y no transfiere el posicionamiento de búsqueda.
¿Cuándo deben las API REST modernas utilizar 307 Temporary Redirect en lugar de 302?
Los primeros navegadores transformaban las solicitudes redirigidas con método POST en peticiones GET al recibir un código 302. El estándar RFC 9110 introdujo los códigos 307 y 308 para asegurar taxativamente que los clientes conserven el método HTTP y el cuerpo de la petición original.
¿Qué produce un error 502 Bad Gateway y cómo pueden solucionarlo los desarrolladores?
Un error 502 sucede cuando un proxy intermedio (Nginx, Cloudflare) recibe una respuesta vacía o no válida de un servidor backend. Las causas habituales incluyen bloqueos del proceso de backend, agotamiento del grupo de conexiones o cortes en cortafuegos internos.
¿Cuál es la diferencia entre 502 Bad Gateway y 504 Gateway Timeout?
Un error 502 indica que el servidor backend respondió con datos incorrectos o cerró la conexión TCP de inmediato. Un error 504 señala que el proxy inverso esperó durante todo el intervalo de tiempo límite sin recibir ninguna respuesta del backend.
¿Qué provoca un código de estado 429 Too Many Requests?
El código de estado 429 se emite según el RFC 6585 cuando un cliente supera los límites de frecuencia de peticiones (rate limiting). Las API suelen incluir un encabezado Retry-After que indica cuántos segundos debe esperar el cliente antes de volver a intentarlo.
¿Cuál es la diferencia entre 400 Bad Request y 422 Unprocessable Content?
Un 400 refleja un fallo en la sintaxis de la estructura (por ejemplo, JSON mal formado). Un 422 (RFC 9110 Sección 15.5.21) indica que la sintaxis JSON es válida, pero los datos incumplen las reglas de negocio (como una dirección de correo no válida).
¿Qué códigos de estado HTTP son almacenables en caché por defecto según RFC 9111?
Según el estándar RFC 9111, los códigos de estado 200, 203, 204, 206, 300, 301, 404, 405, 410, 414 y 501 son almacenables en caché por defecto, salvo que se anulen mediante encabezados explícitos Cache-Control.
¿Son oficiales los códigos de Cloudflare del 520 al 526 y Nginx 499?
No. Los códigos del 520 al 526 son errores perimetrales propietarios de Cloudflare relacionados con la conexión al servidor de origen o problemas de certificados SSL. El código 499 es un estado interno de Nginx que indica que el cliente cerró la conexión TCP antes de que finalizara la respuesta.