Saltar al contenido
helpyself

Códigos de estado HTTP

Solo local: no se sube nada salvo que lo guardes o lo compartas.

Todos los códigos de estado HTTP, qué significan y cuándo enviarlos, con la RFC que los define.

  1. Escribe el código, por ejemplo 404, o una palabra como "redirección" en el buscador.
  2. Lee qué significa el código, cuándo enviarlo y qué RFC lo define.
  3. Elige una clase como 4xx, o vacía el buscador para ver todos los códigos agrupados por clase.

4xx · Errores del cliente

404

Not Found

El servidor no tiene nada en esta dirección, o no quiere decir si lo tiene.

Cuándo usarlo: La respuesta a un enlace roto o una URL mal escrita. También se usa en lugar de 403 para ocultar que un recurso privado existe. Si ha desaparecido para siempre, 410 lo dice.

Definido en RFC 9110 §15.5.5

Guardar esta herramienta

Ten Códigos de estado HTTP a mano

Añadir a marcadores
Insertar

Pon Códigos de estado HTTP en tu web

Pega esto en tu página. Muestra la herramienta, gratis, con un enlace a ella.

Sobre esta herramienta

Todos los códigos de estado HTTP del registro oficial de la IANA, desde 100 Continue hasta 511 Network Authentication Required, cada uno con una explicación clara de qué significa, cuándo debe enviarlo un servidor y un enlace a la sección de la RFC que lo define. Escribe un número, la primera cifra de una clase ("4" o "4xx") o una palabra como "redirección" o "límite", y la lista se va filtrando mientras escribes. Las diferencias que importan están explicadas en lugar de dejarlas al nombre. 401 Unauthorized significa que la petición no está autenticada (inicia sesión y vuelve a intentarlo), mientras que 403 Forbidden significa que el servidor entendió la petición y aun así dice que no. Con 301 y 302 un cliente antiguo puede convertir un POST en un GET de camino a la nueva dirección; 308 y 307 son esas mismas dos redirecciones con la garantía de que el método se mantiene. 422 Unprocessable Content ya no es un añadido de WebDAV: la RFC 9110 lo incorporó a HTTP en 2022, y por eso es la respuesta habitual a un error de validación. Los nombres se mantienen tal como los escribe la especificación, porque es lo que aparece en la línea de estado, en tus logs y en cualquier biblioteca. Cuando un código ha cambiado de nombre (413 era Payload Too Large, 422 era Unprocessable Entity) también se muestra el nombre antiguo, y la búsqueda lo encuentra. También está 418 I'm a teapot, marcado como lo que es: una broma del Día de los Inocentes anglosajón (April Fools') de la RFC 2324 que la RFC 9110 reserva ahora para que nadie le dé al número un uso real. Los códigos no oficiales, como el 499 de nginx o los 520 a 526 de Cloudflare, no están en el registro y no aparecen como si lo estuvieran. Todo funciona en tu navegador y sin conexión una vez cargada la página.

Preguntas frecuentes

¿Qué diferencia hay entre 401 y 403?

401 Unauthorized significa que la petición no lleva credenciales válidas: el servidor no sabe quién eres y debe indicar cómo autenticarse en una cabecera WWW-Authenticate. Iniciar sesión puede resolverlo. 403 Forbidden significa que el servidor entendió la petición y la rechaza de todos modos: repetirla con las mismas credenciales no sirve, solo una cuenta con el permiso adecuado lo haría. Pese a su nombre, 401 trata de autenticación y 403 de permisos.

¿Uso 301 o 308 para una redirección permanente?

Para una página web sirven los dos, y 301 es el que todos los rastreadores y navegadores manejan desde hace décadas; los buscadores tratan ambos igual. La diferencia está en el método. Con 301, un cliente antiguo puede convertir un POST en un GET al seguir la redirección, mientras que 308 garantiza que el método y el cuerpo se mantienen exactamente igual. Para un endpoint de API que acepta POST o PUT, usa 308. La pareja temporal funciona igual: 302 puede cambiar el método, 307 no debe hacerlo.

¿Qué significa 304 Not Modified?

Responde a una petición condicional, enviada con If-None-Match o If-Modified-Since, e indica que la copia que el cliente ya tiene sigue vigente, así que no se envía cuerpo. Así es como la caché ahorra ancho de banda, y no es un error: ver muchos 304 en tus logs significa que la caché funciona.

¿Para un error de validación es correcto 422 o 400?

Usa 400 cuando la petición ni siquiera se puede leer: JSON roto, una cabecera obligatoria que falta. Usa 422 Unprocessable Content cuando está bien formada pero su contenido no se puede procesar, por ejemplo un campo de correo que no contiene una dirección de correo. 422 nació en WebDAV y la RFC 9110 lo incorporó a HTTP en 2022, así que ya no es una extensión.

¿Qué diferencia hay entre 502, 503 y 504?

Los tres suelen venir de un proxy o un balanceador de carga, no de tu aplicación. 502 Bad Gateway significa que el servidor que hay detrás envió una respuesta no válida o ninguna, a menudo porque se ha caído. 503 Service Unavailable significa que el servidor está en marcha pero ahora no puede atender la petición, por sobrecarga o mantenimiento, idealmente con una cabecera Retry-After. 504 Gateway Timeout significa que el servidor detrás del proxy tardó demasiado en responder.

¿418 I'm a teapot es un código de estado real?

Empezó como una broma: la RFC 2324, una RFC del April Fools' de 1998, lo definió para cafeteras a las que se pide preparar café y que en realidad son teteras. Nunca se pensó para implementarse, pero tantos frameworks lo añadieron que la RFC 9110 marca ahora el 418 como reservado, para que el número no pueda recibir un significado real. Usarlo en producción es una broma que los clientes de tu API tienen que entender.

¿Por qué no aparecen 499, 509 y 520?

No son códigos de estado HTTP registrados. nginx registra 499 cuando el cliente cerró la conexión antes de la respuesta, 509 Bandwidth Limit Exceeded lo usan algunos proveedores de alojamiento y 520 a 526 son errores propios de Cloudflare para problemas al contactar con el servidor de origen. Cada uno solo significa algo en ese producto, así que la lista se ciñe al registro oficial.

Ayuda a mejorar esta herramienta

¿Has encontrado un fallo, quieres un cambio o te falta alguna herramienta?

/http-status-codes

↑↓ para moverte · Enter para abrir · Esc para cerrar