Saltar al contenido

Herramienta gratis · texto y datos

Códigos de estado HTTP: lista completa con significado y cuándo usarlos

Todos los códigos de estado HTTP que vas a encontrar — 200, 301, 404, 429, 500, 502 y más — con lo que significan, cuándo debe usarlos una API y la RFC. Busca por número o palabra.

Gratis, sin registro para usarla · lo que escribes o subes se queda en tu dispositivo · funciona sin conexión · Cómo funciona

1xx Informativos

La petición se recibió y aún se está procesando.

  • 100 Continue

    Se aceptaron los headers; envía el cuerpo.

    RFC 9110
  • 101 Switching Protocols

    El servidor cambia al protocolo que pidió el cliente.

    RFC 9110
  • 103 Early Hints

    Headers enviados antes para que el navegador empiece a cargar recursos.

    RFC 8297

2xx Éxito

La petición funcionó.

  • 200 OK Más usados

    Éxito, con el resultado en el cuerpo.

    RFC 9110
  • 201 Created Más usados

    Se creó un recurso nuevo.

    RFC 9110
  • 202 Accepted

    Aceptado para procesar, y aún no ha terminado.

    RFC 9110
  • 204 No Content Más usados

    Éxito, sin nada en el cuerpo.

    RFC 9110
  • 206 Partial Content

    Solo una parte del recurso, pedida con el header Range.

    RFC 9110

3xx Redirección

El cliente debe ir a otro lugar o usar su copia en caché.

  • 301 Moved Permanently Más usados

    El recurso tiene una nueva URL permanente.

    RFC 9110
  • 302 Found

    Temporalmente en otra URL.

    RFC 9110
  • 303 See Other

    Obtén el resultado en otra URL, con GET.

    RFC 9110
  • 304 Not Modified Más usados

    Tu copia en caché sigue siendo válida.

    RFC 9110
  • 307 Temporary Redirect

    Temporalmente en otra URL; repite el mismo método y cuerpo.

    RFC 9110
  • 308 Permanent Redirect

    Definitivamente en otra URL; repite el mismo método y cuerpo.

    RFC 9110

4xx Error del cliente

La petición tiene un problema: corrígelo antes de reintentar.

  • 400 Bad Request Más usados

    La petición está mal formada.

    RFC 9110
  • 401 Unauthorized Más usados

    Falta la autenticación o no es válida.

    RFC 9110
  • 402 Payment Required

    Reservado para uso futuro; algunas APIs lo usan para facturación.

    RFC 9110
  • 403 Forbidden Más usados

    Autenticado, pero sin permiso.

    RFC 9110
  • 404 Not Found Más usados

    No hay nada en esta URL.

    RFC 9110
  • 405 Method Not Allowed

    La URL existe, pero no con este método.

    RFC 9110
  • 406 Not Acceptable

    Ninguna versión cumple los headers Accept.

    RFC 9110
  • 408 Request Timeout

    El cliente tardó demasiado en enviar la petición.

    RFC 9110
  • 409 Conflict Más usados

    Entra en conflicto con el estado actual del recurso.

    RFC 9110
  • 410 Gone

    Existió y se eliminó definitivamente.

    RFC 9110
  • 411 Length Required

    El header Content-Length es obligatorio.

    RFC 9110
  • 412 Precondition Failed

    Una condición en los headers (If-Match…) es falsa.

    RFC 9110
  • 413 Content Too Large

    El cuerpo es más grande de lo que acepta el servidor.

    RFC 9110
  • 414 URI Too Long

    La URL es demasiado larga.

    RFC 9110
  • 415 Unsupported Media Type Más usados

    No se acepta el formato del cuerpo.

    RFC 9110
  • 416 Range Not Satisfiable

    El Range pedido está fuera del archivo.

    RFC 9110
  • 418 I'm a teapot

    Una broma del Día de los Inocentes de 1998: el servidor es una tetera.

    RFC 2324
  • 422 Unprocessable Content Más usados

    Bien formada, pero los datos no pasan la validación.

    RFC 9110
  • 425 Too Early

    El servidor no procesa una petición que podría repetirse.

    RFC 8470
  • 426 Upgrade Required

    Usa otro protocolo (indicado en Upgrade).

    RFC 9110
  • 428 Precondition Required

    La petición debe ser condicional (If-Match).

    RFC 6585
  • 429 Too Many Requests Más usados

    Demasiadas peticiones en un periodo (límite de tasa).

    RFC 6585
  • 431 Request Header Fields Too Large

    Los headers son demasiado grandes.

    RFC 6585
  • 451 Unavailable For Legal Reasons

    Bloqueado por motivos legales.

    RFC 7725

5xx Error del servidor

El servidor falló con una petición válida; reintentar más tarde puede funcionar.

  • 500 Internal Server Error Más usados

    Error inesperado en el servidor.

    RFC 9110
  • 501 Not Implemented

    El servidor no admite esta función.

    RFC 9110
  • 502 Bad Gateway Más usados

    Un proxy o gateway recibió una respuesta no válida del servidor que tiene detrás.

    RFC 9110
  • 503 Service Unavailable Más usados

    No disponible temporalmente.

    RFC 9110
  • 504 Gateway Timeout Más usados

    Un proxy o gateway esperó demasiado al servidor que tiene detrás.

    RFC 9110
  • 505 HTTP Version Not Supported

    La versión de HTTP no es compatible.

    RFC 9110
  • 507 Insufficient Storage

    No hay espacio para guardar lo enviado.

    RFC 4918
  • 511 Network Authentication Required

    Inicia sesión en la red primero.

    RFC 6585

Fuentes: RFC 2324 , RFC 4918 , RFC 6585 , RFC 7725 , RFC 8297 , RFC 8470 , RFC 9110

Patrocina esta herramienta

Sobre esta herramienta

Los códigos de estado HTTP son la respuesta de tres dígitos de cada petición web: 2xx significa que funcionó, 3xx que el cliente debe ir a otro lugar, 4xx que la petición tiene un problema y 5xx que falló el servidor. Esta referencia recoge los códigos de la RFC 9110 y las extensiones comunes (429 Too Many Requests, 103 Early Hints, 451…), cada uno con su frase oficial, una explicación sencilla, cuándo debe devolverlo una API o un sitio web y un enlace a la especificación. Busca por número (4 muestra todos los 4xx) o por palabra (timeout, redirect, cache), o filtra por clase o por los más usados. Resuelve las dudas clásicas: 401 o 403, 301 o 308, 400 o 422, 502 o 504.

Cómo usarla

  1. 1 Escribe un código o una palabra, como 404, 50 o timeout.
  2. 2 O filtra por clase (1xx a 5xx) o por los códigos más usados.
  3. 3 Lee qué significa el código y cuándo usarlo.
  4. 4 Abre el enlace de la RFC para la definición exacta.

Preguntas frecuentes

¿Qué diferencia hay entre 401 y 403?

401 Unauthorized significa que la petición no tiene credenciales válidas: el cliente debe iniciar sesión o renovar el token. 403 Forbidden significa que el servidor sabe quién eres y aun así lo rechaza: volver a iniciar sesión no ayuda.

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

Para páginas web, 301 es lo habitual y lo entienden todos los navegadores y buscadores. 308 significa lo mismo pero garantiza que se repiten el método y el cuerpo, así que úsalo en endpoints de API que reciben POST o PUT.

¿Cuándo debe una API devolver 400 y cuándo 422?

Usa 400 cuando la petición no se puede leer: JSON roto, un parámetro que falta o tipos incorrectos. Usa 422 cuando está bien formada pero los datos no cumplen tus reglas, como un correo no válido o una fecha en el pasado.

Incorporar esta herramienta

Agrega esta herramienta gratuita a tu sitio — copia el código abajo. Se mantiene siempre actualizado.

Herramientas para tu sitio →

Más en Desarrolladores

Desarrolladores · Ver las 122 herramientas gratis