Referencia de códigos de estado HTTP

Cómo funciona

Toda respuesta HTTP empieza con un código de tres cifras, y el primer dígito ya indica en cuál de las cinco clases estás. Esta referencia cubre los 46 códigos que un desarrollador ve de verdad, cada uno con un resumen de una línea y una nota ampliada con la causa común y la primera acción a intentar — filtra por clase, busca por código o frase y pulsa cualquier fila para abrirla.

Las cinco clases

1xx es informativo: señales intermedias que suelen completarse dentro del manejo de conexión del cliente. 2xx es éxito, con variantes para creado (201), aceptado-pero-inacabado (202) y deliberadamente vacío (204). 3xx es redirección: ve a otra URL bajo reglas explícitas. 4xx es error del cliente: la petición enviada no era aceptable. 5xx es error del servidor: la petición estaba bien pero el servidor no pudo cumplir. La división más útil al depurar: 4xx mira lo que enviaste, 5xx mira lo que ellos ejecutan.

Idempotencia y reintentos

Seguros de reintentar con retroceso: 408, 425, 429 (respeta Retry-After) y la familia 5xx —500, 502, 503, 504—. Nunca merecen reintentos a ciegas los 4xx sobre el propio payload (400, 413, 415) ni los fallos de autorización (401, 403). Códigos como 409 y 412 solo admiten reintento tras leer el estado fresco y resolver el conflicto: repetir la misma petición vuelve a fallar.

Redirecciones permanentes frente a temporales

301 y 308 se cachean en la práctica para siempre: úsalos solo si la URL vieja no volverá, y sabe que un error persigue a los usuarios incluso tras arreglar el servidor. 302, 303 y 307 no se almacenan —el navegador vuelve a preguntar por la URL original— y difieren en cómo reescriben el método: 303 fuerza GET, 307 preserva el método, 302 lo conserva en la práctica pero sin garantía.

Preguntas frecuentes