Consulta de códigos de estado HTTP

Funciones

• Búsqueda por número: significado, clase 1xx–5xx, nombre habitual, usos típicos y notas de diagnóstico
• Búsqueda inversa por palabra clave, en chino o en inglés
• Escribe uno o dos dígitos para listar todo un grupo: 40 lista los códigos 4xx que empiezan por 40
• Los 62 códigos están en una lista desplegable con búsqueda, agrupados por 1xx–5xx: no hace falta saberse el número
• Los que se confunden se apuntan entre sí: 401 y 403, 301 y 308, 502 y 504
• Cubre 62 códigos comunes; un número sin entrada recibe la explicación de su clase en vez de un hueco
• El idioma de la descripción se puede cambiar entre chino e inglés, y la búsqueda coincide en los dos

Cómo se usa

1. Escribe un código de tres dígitos (404) o una palabra clave (rate limit), o explora la lista desplegable por grupos
2. Cambia el idioma de la descripción o desactiva los códigos relacionados si lo prefieres
3. El resultado aparece mientras escribes: no hay botón que pulsar

Preguntas frecuentes

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

Un 401 significa que la petición no está autenticada: no hay credenciales, o son inválidas o han caducado. La solución es volver a iniciar sesión o refrescar el token. Un 403 significa que sí está autenticada y el servidor aun así la rechaza: sabe quién eres y no te deja hacer esto, así que volver a iniciar sesión no cambia nada. Según la especificación, un 401 debe llevar la cabecera WWW-Authenticate diciendo cómo autenticarse; un 403 te manda a la configuración de permisos, a bloqueos por IP o región, o a una regla del WAF.

¿301 y 302 son solo permanente frente a temporal?

No del todo. Un 301 lo cachea el navegador a largo plazo, y ese cacheo es heurístico: puede recordarlo aunque no se hayan enviado cabeceras de caché, así que un 301 equivocado deja a los usuarios rotos hasta que limpian su caché. Ese es el incidente clásico del 301. Además, los métodos distintos de GET y HEAD los reescriben a GET la mayoría de los navegadores; cuando el método debe sobrevivir, usa 308 (permanente) o 307 (temporal).

¿Cuál es la trampa del 304?

Un 304 solo significa algo junto a cabeceras de caché: el servidor tuvo que haber enviado antes un ETag o un Last-Modified, para que el cliente pueda volver a preguntar si su copia sigue siendo válida. Un 304 sin cabeceras de caché deja al cliente sin contenido y sin copia utilizable, y eso se manifiesta como una página en blanco o una respuesta de API vacía: una mala configuración que nunca da error y es difícil de rastrear hasta un código de estado.

¿En qué se diferencian 502 y 504?

Un 502 es una pasarela que ha recibido una respuesta inválida del servidor de origen: un backend caído, un puerto equivocado, una respuesta que no se puede interpretar. Un 504 es una pasarela que se ha cansado de esperar al origen: un backend lento o una llamada a un tercero atascada. Con un 502, comprueba primero que el proceso de origen sigue vivo y escuchando; con un 504, mira los tiempos del propio backend. Además, las dos páginas de error que ves suelen emitirlas Nginx, así que el registro del backend puede no mostrar nada.

¿Cuántos códigos se cubren?

62 habituales, tomados de las RFC 9110, 9111 y 9112 más extensiones documentadas como los errores de cliente de WebDAV, el 429 para límite de peticiones y el 418 como broma del día de los inocentes. Un número válido pero sin entrada, por ejemplo el 599, recibe la explicación de su clase y una nota diciendo que ese número no está en la tabla, en vez de fingir que se ha encontrado.