Skip to content

Códigos de estado HTTP explicados

Todos los códigos de estado de respuesta HTTP comunes, agrupados por clase: qué significan y cuándo los verás. El compañero de referencia rápida de la herramienta de códigos de estado HTTP.

Los códigos de estado HTTP comparten un patrón: el primer dígito nombra la clase y el resto es detalle. 1xx significa informativo, 2xx éxito, 3xx redirección, 4xx que el cliente cometió un error y 5xx que el servidor falló. Lee primero el primer dígito. La herramienta complementaria te permite consultar un solo código en profundidad.

Tabla de referencia · 55 entradasAbrir la herramienta http-status-codes →
55 of 55 rows
1xx Informativos
ContinueEl servidor recibió las cabeceras de la petición y el cliente puede enviar el cuerpo.Tras una comprobación previa antes de subir un cuerpo grande.
Switching ProtocolsEl servidor acepta cambiar al protocolo que pidió el cliente.Actualizar una conexión HTTP a WebSocket.
ProcessingEl servidor recibió la petición y sigue trabajando en ella.Un servidor WebDAV reconoce una petición larga para que el cliente no caduque.
Early HintsEl servidor envía cabeceras preliminares antes de que la respuesta final esté lista.Permitir que un navegador precargue recursos mientras la página aún se renderiza.
2xx Éxito
OKLa petición tuvo éxito y el cuerpo de la respuesta contiene el resultado.Éxito estándar para un GET o un PUT.
CreatedLa petición tuvo éxito y se creó un nuevo recurso.Devolver tras un POST con éxito que crea algo.
AcceptedLa petición se aceptó para procesarse, pero aún no terminó.Un trabajo largo arrancó y se ejecuta de forma asíncrona.
Non-Authoritative InformationLa petición tuvo éxito, pero los datos devueltos se transformaron en el camino de vuelta.Un proxy o caché sirve metadatos modificados en lugar de los del origen.
No ContentLa petición tuvo éxito y no hay cuerpo que devolver.Un DELETE con éxito, o un PUT sin nada que decir.
Reset ContentLa petición tuvo éxito y el cliente debe restablecer la vista que la envió.Tras enviar un formulario, para que la página limpie sus campos.
Partial ContentEl servidor devuelve solo parte del recurso, tal como se pidió.Servir un rango de bytes de una petición Range.
3xx Redirección
Moved PermanentlyEl recurso tiene una URL nueva permanente y las peticiones futuras deberían usarla.Una página se movió y los buscadores deben actualizar su índice.
FoundEl recurso está temporalmente en otra URL, pero sigue usando la original.Redirigir a una página de login por un momento.
See OtherLa respuesta vive en otra URL y debe obtenerse con un GET.El patrón PRG: redirigir un POST a una página de resultado para que un refresco no reenvíe.
Not ModifiedLa copia en caché sigue siendo válida, así que el servidor no envía cuerpo.GET condicional donde la caché del cliente está al día.
Use ProxyLa petición debe enviarse a través del proxy indicado en la respuesta.Redes de proxy heredadas; obsoleto desde 2011.
Temporary RedirectEl recurso está temporalmente en otro sitio y debe conservarse el método original de la petición.Como 302, pero un POST sigue siendo POST en la redirección.
Permanent RedirectEl recurso tiene una URL nueva permanente y debe conservarse el método original de la petición.Como 301, pero un POST sigue siendo POST en la redirección.
4xx Error del cliente
Bad RequestEl servidor no pudo entender la petición por una sintaxis mal formada.JSON mal formado o un campo obligatorio que falta.
UnauthorizedSe requiere autenticación y faltó o falló.Sin token, o un token inválido o caducado.
Payment RequiredLa petición requiere pago, aunque la especificación nunca definió cómo.Algunas APIs lo usan como marcador de muro de pago; la mayoría nunca lo usa.
ForbiddenEl cliente está autenticado pero no puede acceder a este recurso.Login válido, pero sin permiso para este recurso.
Not FoundEl servidor no tiene ningún recurso en esta URL.URL desconocida o un ID que no existe.
Method Not AllowedLa URL existe pero no permite el método usado en la petición.Un POST contra un endpoint que solo acepta GET.
Not AcceptableEl servidor no puede devolver contenido que coincida con las cabeceras Accept del cliente.El cliente pidió solo XML, pero la API solo devuelve JSON.
Proxy Authentication RequiredEl cliente debe autenticarse con el proxy antes de que la petición continúe.Un proxy corporativo rechaza una petición sin autenticar.
Request TimeoutEl cliente tardó demasiado en enviar la petición y el servidor se rindió.Una subida que se detuvo antes de que el cuerpo terminara de llegar.
ConflictLa petición entra en conflicto con el estado actual del recurso.Un email duplicado o una carrera de edición sobre el mismo registro.
GoneEl recurso existió una vez pero se eliminó de forma permanente.Un endpoint retirado a propósito, más fuerte que 404.
Length RequiredLa petición necesita una cabecera Content-Length y no la tiene.Un servidor que debe conocer el tamaño por adelantado rechaza un cuerpo en streaming.
Precondition FailedUna precondición de cabecera como If-Match se evaluó como falsa.Una edición optimista donde el registro cambió desde que el cliente lo leyó.
Content Too LargeEl cuerpo de la petición supera el límite que acepta el servidor.Una subida mayor que el tamaño máximo de cuerpo del servidor.
URI Too LongLa URL de la petición es más larga de lo que el servidor está dispuesto a interpretar.Un formulario serializado por accidente en una query string GET que creció sin control.
Unsupported Media TypeEl formato del cuerpo de la petición no es uno que el endpoint acepte.Un POST con Content-Type text/plain contra un endpoint solo-JSON.
Range Not SatisfiableEl rango de bytes de la cabecera Range no cabe en el recurso.Pedir bytes más allá del final de un archivo al reanudar una descarga.
Expectation FailedEl servidor no puede cumplir la expectativa indicada en la cabecera Expect.Una expectativa 100-continue que el servidor se niega a honrar.
I'm a teapotEl servidor es una tetera y se niega a preparar café.Una broma del 1 de abril de 1998 que no muere; las APIs la devuelven por diversión.
Misdirected RequestLa petición se envió a un servidor que no puede producir una respuesta para ella.Una conexión reutilizada enviada a un host que este servidor no sirve.
Unprocessable EntityLa petición está bien formada pero sus valores no pasan la validación semántica.JSON válido cuyos campos violan reglas de negocio.
Too EarlyEl servidor rechaza una petición con riesgo de ser una repetición.Rechazar una petición no idempotente reintentada antes de rotar las claves.
Upgrade RequiredEl cliente debe cambiar a un protocolo distinto para usar este recurso.Un endpoint que exige TLS o WebSocket.
Precondition RequiredEl servidor exige cabeceras condicionales que la petición no envió.Una API que exige If-Match para evitar actualizaciones perdidas.
Too Many RequestsEl cliente ha enviado demasiadas peticiones en una ventana de tiempo.Se alcanzó un límite de tasa; espera y reintenta.
Request Header Fields Too LargeUno o más campos de cabecera son demasiado grandes para que el servidor los procese.Una cookie o token que creció hasta bloquear cada petición al sitio.
Unavailable For Legal ReasonsEl recurso está bloqueado por razones legales, como una retirada o una restricción geográfica.Una retirada gubernamental o una página bloqueada en un país.
5xx Error del servidor
Internal Server ErrorEl servidor sufrió una condición inesperada y falló.Una excepción sin manejar o un bug en el servidor.
Not ImplementedEl servidor no admite el método o la función solicitada.Un endpoint está declarado pero aún sin construir.
Bad GatewayUna pasarela o proxy recibió una respuesta inválida de un servidor de origen.Un proxy inverso no pudo alcanzar el backend.
Service UnavailableEl servidor no puede atender temporalmente la petición.Mantenimiento, sobrecarga o un servicio del que depende caído.
Gateway TimeoutUna pasarela o proxy no recibió a tiempo una respuesta del servidor de origen.El backend tardó demasiado y el proxy se rindió.
HTTP Version Not SupportedEl servidor no admite la versión HTTP de la petición.Un cliente que habla una versión de protocolo que el servidor nunca aprendió.
Variant Also NegotiatesLa negociación transparente de contenido terminó en una referencia circular.Un servidor mal configurado con negociación de contenido experimental.
Insufficient StorageEl servidor no puede almacenar la representación necesaria para completar la petición.Un servidor WebDAV con su almacenamiento asignado lleno.
Loop DetectedEl servidor entró en un bucle infinito al procesar la petición.Un enlace WebDAV que se refiere a sí mismo.
Network Authentication RequiredEl cliente debe autenticarse con la red para obtener acceso.Un portal cautivo en un hotel o aeropuerto intercepta la petición.