2xx · Correctos
200
OK
La petición ha tenido éxito. Lo que contiene el cuerpo depende del método: el recurso en un GET, el resultado de la acción en un POST.
Cuándo usarlo: La respuesta por defecto a una petición que ha funcionado. Cuando se ha creado algo nuevo, 201 dice más.
Definido en RFC 9110 §15.3.1
201
Created
La petición ha tenido éxito y ha creado uno o más recursos nuevos.
Cuándo usarlo: La respuesta a un POST o PUT que creó algo, con una cabecera Location que apunta al nuevo recurso.
Definido en RFC 9110 §15.3.2
202
Accepted
La petición se ha aceptado para procesarla, pero el procesamiento no ha terminado y todavía puede fallar.
Cuándo usarlo: Para trabajo que se hace en segundo plano (una tarea en cola, una importación masiva), idealmente con un enlace donde el cliente pueda consultar el progreso.
Definido en RFC 9110 §15.3.3
203
Non-Authoritative Information
La petición ha tenido éxito, pero un proxy intermedio ha modificado la respuesta que recibió del servidor de origen.
Cuándo usarlo: Lo envían los proxies que transforman contenido para indicar que no es exactamente lo que mandó el origen. Se ve poco.
Definido en RFC 9110 §15.3.4
204
No Content
La petición ha tenido éxito y la respuesta no lleva cuerpo, a propósito.
Cuándo usarlo: Una respuesta habitual a un DELETE, o a un PUT cuando el cliente no necesita una copia de vuelta.
Definido en RFC 9110 §15.3.5
205
Reset Content
La petición ha tenido éxito y el cliente debe restablecer la vista que la envió, por ejemplo vaciar un formulario.
Cuándo usarlo: Pensado para interfaces de introducción de datos que quieren el formulario vacío para la siguiente entrada. En la práctica los navegadores hacen poco con él.
Definido en RFC 9110 §15.3.6
206
Partial Content
El servidor envía solo la parte del recurso que el cliente pidió en una cabecera Range.
Cuándo usarlo: Así es como el salto en un vídeo, las descargas reanudadas y los gestores de descargas obtienen un archivo por partes.
Definido en RFC 9110 §15.3.7
207
Multi-Status
Una respuesta WebDAV cuyo cuerpo XML contiene un estado distinto para cada uno de varios recursos.
Cuándo usarlo: Para una sola petición que actuó sobre muchos elementos, donde unos pueden haber salido bien y otros mal.
Definido en RFC 4918
208
Already Reported
Se usa dentro de una respuesta WebDAV 207 para indicar que los miembros de un recurso ya se listaron antes en la misma respuesta.
Cuándo usarlo: Evita repetir el mismo elemento cuando una colección es accesible a través de más de un enlace (binding).
Definido en RFC 5842
226
IM Used
El servidor ha atendido un GET y la respuesta es el resultado de manipulaciones de instancia, como un delta, aplicadas al recurso actual.
Cuándo usarlo: Forma parte de la codificación delta de HTTP (RFC 3229), en la que un cliente pide solo lo que ha cambiado desde su copia. Casi nunca se implementa.
Definido en RFC 3229
3xx · Redirecciones
300
Multiple Choices
El recurso tiene varias representaciones y el cliente o el usuario debe elegir una.
Cuándo usarlo: Se usa poco, porque no hay una forma estándar de elegir automáticamente; los servidores suelen escoger una y enviarla.
Definido en RFC 9110 §15.4.1
301
Moved Permanently
El recurso tiene una nueva dirección permanente, indicada en la cabecera Location, y los enlaces deben actualizarse a ella.
Cuándo usarlo: Para una página que se ha trasladado definitivamente. Los buscadores pasan su posicionamiento a la nueva dirección. Un cliente puede convertir un POST en un GET al seguirla, así que usa 308 cuando el método importe.
Definido en RFC 9110 §15.4.2
302
Found
También conocido como: Moved Temporarily
El recurso está temporalmente en otra dirección, indicada en la cabecera Location; la dirección original sigue siendo la que hay que usar.
Cuándo usarlo: Para un traslado pasajero, como enviar a los visitantes a una página de inicio de sesión. Los clientes pueden cambiar POST por GET al seguirla; 307 lo prohíbe.
Definido en RFC 9110 §15.4.3
303
See Other
La respuesta está en otra dirección, y el cliente debe obtenerla con un GET.
Cuándo usarlo: La respuesta clásica tras enviar un formulario por POST (Post/Redirect/Get), para que recargar la página de resultado no vuelva a enviar el formulario.
Definido en RFC 9110 §15.4.4
304
Not Modified
La copia en caché del cliente sigue vigente, así que el servidor no envía cuerpo.
Cuándo usarlo: La respuesta a un GET condicional con If-None-Match o If-Modified-Since cuando nada ha cambiado. No es un error: es la caché funcionando.
Definido en RFC 9110 §15.4.5
305
Use Proxy
En desusoEn su día indicaba al cliente que repitiera la petición a través del proxy indicado en la cabecera Location.
Cuándo usarlo: Obsoleto por motivos de seguridad, ya que permitía a una respuesta desviar el tráfico por el proxy que quisiera. No lo envíes.
Definido en RFC 9110 §15.4.6
306
(Unused)
En desusoReservado. Un borrador anterior lo definía como Switch Proxy, y nunca se usó.
Cuándo usarlo: No lo envíes nunca. El número sigue reservado para que no se reutilice.
Definido en RFC 9110 §15.4.7
307
Temporary Redirect
El recurso está temporalmente en la dirección de la cabecera Location, y el cliente debe repetir allí la petición con el mismo método y el mismo cuerpo.
Cuándo usarlo: La redirección temporal adecuada cuando un POST debe seguir siendo un POST. Los saltos de http a https por HSTS también aparecen en los navegadores como un 307.
Definido en RFC 9110 §15.4.8
308
Permanent Redirect
El recurso se ha trasladado de forma permanente a la dirección de la cabecera Location, y el cliente debe mantener el mismo método y el mismo cuerpo.
Cuándo usarlo: Una redirección permanente para una API o cualquier endpoint que acepte POST o PUT, donde un 301 podría convertir la petición en un GET.
Definido en RFC 9110 §15.4.9
4xx · Errores del cliente
400
Bad Request
El servidor no puede procesar la petición por algo que considera un error del cliente, como una sintaxis mal formada.
Cuándo usarlo: Para una petición que ni siquiera se puede interpretar: JSON roto, una cabecera no válida, un parámetro obligatorio que falta.
Definido en RFC 9110 §15.5.1
401
Unauthorized
La petición no tiene credenciales de autenticación válidas para el recurso. Pese al nombre, trata de autenticación, no de permisos.
Cuándo usarlo: Cuando el cliente no ha iniciado sesión o su token ha caducado. La respuesta debe incluir una cabecera WWW-Authenticate que indique cómo autenticarse.
Definido en RFC 9110 §15.5.2
402
Payment Required
Reservado para uso futuro. La especificación nunca ha definido qué debe hacer.
Cuándo usarlo: Algunas API lo envían cuando una suscripción ha vencido o un pago ha fallado, pero no hay un comportamiento estándar detrás.
Definido en RFC 9110 §15.5.3
403
Forbidden
El servidor entendió la petición y se niega a atenderla. Enviar de nuevo las mismas credenciales no cambiará la respuesta.
Cuándo usarlo: Cuando se sabe quién es el usuario pero no tiene permiso: la cuenta de otra persona, una página de administración, un país o una IP bloqueados.
Definido en RFC 9110 §15.5.4
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
405
Method Not Allowed
El servidor conoce el método, pero este recurso no lo admite.
Cuándo usarlo: Para un POST a una dirección de solo lectura, o un DELETE donde no hay nada que borrar. La respuesta debe listar los métodos permitidos en una cabecera Allow.
Definido en RFC 9110 §15.5.6
406
Not Acceptable
El servidor no puede generar una respuesta en ningún formato de los que el cliente dijo aceptar en sus cabeceras Accept.
Cuándo usarlo: Una negociación de contenido sin nada en común, como un cliente que solo acepta XML ante una API que solo habla JSON. La mayoría de servidores envían su formato por defecto en su lugar.
Definido en RFC 9110 §15.5.7
407
Proxy Authentication Required
Como 401, pero quien necesita que el cliente se autentique es un proxy situado entre el cliente y el servidor.
Cuándo usarlo: Lo envían los proxies corporativos y otros proxies con autenticación, con una cabecera Proxy-Authenticate que indica cómo.
Definido en RFC 9110 §15.5.8
408
Request Timeout
El servidor se ha cansado de esperar a que el cliente terminara de enviar su petición.
Cuándo usarlo: Se envía en una conexión inactiva antes de que el servidor la cierre. El cliente puede simplemente repetir la petición en una conexión nueva.
Definido en RFC 9110 §15.5.9
409
Conflict
La petición entra en conflicto con el estado actual del recurso.
Cuándo usarlo: Una edición basada en una versión desfasada, un nombre de usuario que ya está cogido o subir un archivo cuyo nombre ya está en uso.
Definido en RFC 9110 §15.5.10
410
Gone
El recurso estuvo aquí y se ha eliminado a propósito, sin dirección de reenvío.
Cuándo usarlo: Para contenido retirado definitivamente. Indica a los buscadores con más firmeza que un 404 que la página no volverá.
Definido en RFC 9110 §15.5.11
411
Length Required
El servidor rechaza una petición que lleva cuerpo pero no tiene cabecera Content-Length.
Cuándo usarlo: Lo envían los servidores que no aceptan subidas por fragmentos (chunked) de longitud desconocida.
Definido en RFC 9110 §15.5.12
412
Precondition Failed
No se cumplió una condición de las cabeceras de la petición, como If-Match o If-Unmodified-Since.
Cuándo usarlo: Protege contra actualizaciones perdidas: el recurso cambió desde la última vez que el cliente lo leyó, así que se rechaza la escritura.
Definido en RFC 9110 §15.5.13
413
Content Too Large
También conocido como: Payload Too Large, Request Entity Too Large
El cuerpo de la petición es más grande de lo que el servidor quiere o puede manejar. La RFC 9110 le cambió el nombre, que antes era Payload Too Large.
Cuándo usarlo: Una subida que supera el límite de tamaño. Si el límite es temporal, una cabecera Retry-After indica cuándo volver a intentarlo.
Definido en RFC 9110 §15.5.14
414
URI Too Long
También conocido como: Request-URI Too Long
La URI de la petición es más larga de lo que el servidor está dispuesto a leer.
Cuándo usarlo: Normalmente un formulario enviado por GET con una query string enorme, o un bucle de redirecciones que no paraba de alargar la URL. Envía los datos en el cuerpo de un POST.
Definido en RFC 9110 §15.5.15
415
Unsupported Media Type
El servidor rechaza la petición porque el cuerpo está en un formato que no admite.
Cuándo usarlo: Un Content-Type erróneo o ausente, como datos de formulario enviados a un endpoint que solo acepta application/json.
Definido en RFC 9110 §15.5.16
416
Range Not Satisfiable
También conocido como: Requested Range Not Satisfiable
Ninguno de los rangos de la cabecera Range de la petición coincide con el recurso.
Cuándo usarlo: Pedir bytes más allá del final del archivo, a menudo al reanudar la descarga de un archivo que desde entonces se ha hecho más pequeño.
Definido en RFC 9110 §15.5.17
417
Expectation Failed
El servidor no puede cumplir el requisito de la cabecera Expect de la petición.
Cuándo usarlo: Se ve sobre todo cuando un proxy o servidor no admite Expect: 100-continue. Repetir la petición sin esa cabecera suele funcionar.
Definido en RFC 9110 §15.5.18
418
(Unused)
En desusoTambién conocido como: I'm a teapot
El código de broma de April Fools' de la RFC 2324: una tetera que se niega a preparar café. La RFC 9110 reserva el número para que nunca reciba un significado real.
Cuándo usarlo: No es para producción. Algunos sitios lo envían como huevo de Pascua o para rechazar bots, pero no se puede esperar que los clientes lo entiendan.
Definido en RFC 9110 §15.5.19
421
Misdirected Request
La petición llegó a un servidor que no puede generar una respuesta para el host que indica.
Cuándo usarlo: Ocurre sobre todo con la reutilización de conexiones de HTTP/2, cuando una conexión se comparte entre nombres de host para los que el servidor no está configurado. El cliente debe repetirla en una conexión nueva.
Definido en RFC 9110 §15.5.20
422
Unprocessable Content
También conocido como: Unprocessable Entity
El servidor entiende el tipo de contenido y la sintaxis es correcta, pero no puede procesar lo que contiene la petición. Antes se llamaba Unprocessable Entity.
Cuándo usarlo: La respuesta habitual a un error de validación en una petición bien formada. Forma parte del propio HTTP desde la RFC 9110, no solo de WebDAV.
Definido en RFC 9110 §15.5.21
423
Locked
El recurso WebDAV al que se accede está bloqueado.
Cuándo usarlo: Un archivo que otro usuario ha bloqueado para editarlo.
Definido en RFC 4918
424
Failed Dependency
La petición falló porque falló otra acción de la que dependía.
Cuándo usarlo: En un lote WebDAV, las operaciones que no pudieron ejecutarse porque una anterior de la misma petición falló.
Definido en RFC 4918
425
Too Early
El servidor no se arriesga a procesar una petición que podría reproducirse de nuevo.
Cuándo usarlo: Para peticiones enviadas como early data de TLS 1.3 (0-RTT), que un atacante podría repetir. El cliente debe reintentarla cuando termine el handshake.
Definido en RFC 8470
426
Upgrade Required
El servidor rechaza la petición con el protocolo actual, pero la aceptaría si el cliente se actualiza a otro.
Cuándo usarlo: Se envía con una cabecera Upgrade que indica el protocolo necesario, por ejemplo una versión más reciente de HTTP o de TLS.
Definido en RFC 9110 §15.5.22
428
Precondition Required
El servidor exige que la petición sea condicional, con una cabecera como If-Match.
Cuándo usarlo: Obliga a los clientes a demostrar qué versión están modificando, para que dos ediciones no se sobrescriban sin que nadie se dé cuenta.
Definido en RFC 6585
429
Too Many Requests
El cliente ha enviado demasiadas peticiones en un periodo de tiempo determinado.
Cuándo usarlo: Limitación de peticiones (rate limiting). Una cabecera Retry-After indica cuánto esperar; los clientes deben espaciar los intentos en vez de reintentar al momento.
Definido en RFC 6585
431
Request Header Fields Too Large
El servidor no procesará la petición porque sus cabeceras, o una de ellas, son demasiado grandes.
Cuándo usarlo: Casi siempre una cookie enorme, o demasiadas cookies para un dominio. Borrar las cookies del sitio suele solucionarlo.
Definido en RFC 6585
451
Unavailable For Legal Reasons
El servidor deniega el acceso al recurso por una exigencia legal.
Cuándo usarlo: Contenido bloqueado por una orden judicial, una petición del gobierno o una retirada en un país. El número es un guiño a la novela Fahrenheit 451.
Definido en RFC 7725
5xx · Errores del servidor
500
Internal Server Error
El servidor se encontró con una situación inesperada que le impidió atender la petición.
Cuándo usarlo: El cajón de sastre para un fallo o una excepción no controlada. Los logs del propio servidor dicen qué pasó de verdad; el cliente normalmente no puede arreglarlo.
Definido en RFC 9110 §15.6.1
501
Not Implemented
El servidor no admite la funcionalidad necesaria para atender la petición.
Cuándo usarlo: Un método que el servidor no reconoce en absoluto. A diferencia de 405, significa que ningún recurso de este servidor lo admite.
Definido en RFC 9110 §15.6.2
502
Bad Gateway
Un servidor que actúa como gateway o proxy recibió una respuesta no válida, o ninguna, del servidor que tiene detrás.
Cuándo usarlo: La aplicación que hay detrás de nginx, un balanceador de carga o una CDN se ha caído, se está reiniciando o no es accesible.
Definido en RFC 9110 §15.6.3
503
Service Unavailable
El servidor no puede atender la petición ahora mismo, porque está sobrecargado o en mantenimiento.
Cuándo usarlo: Una situación temporal. Envía una cabecera Retry-After que indique cuándo volver; los buscadores tratan un 503 como temporal y conservan la página.
Definido en RFC 9110 §15.6.4
504
Gateway Timeout
Un servidor que actúa como gateway o proxy no recibió a tiempo una respuesta del servidor que tiene detrás.
Cuándo usarlo: Una consulta lenta a la base de datos o un backend que tarda en responder más que el tiempo de espera del proxy.
Definido en RFC 9110 §15.6.5
505
HTTP Version Not Supported
El servidor no admite la versión principal de HTTP usada en la petición.
Cuándo usarlo: Raro, porque casi todos los servidores hablan HTTP/1.1, HTTP/2 y a menudo HTTP/3.
Definido en RFC 9110 §15.6.6
506
Variant Also Negotiates
Un error de configuración del servidor en la negociación transparente de contenido: la variante elegida está configurada a su vez para negociar, lo que crearía un bucle.
Cuándo usarlo: Viene de la negociación de contenido experimental (RFC 2295) y casi nunca se ve.
Definido en RFC 2295
507
Insufficient Storage
El servidor no puede almacenar lo que la petición necesita que almacene.
Cuándo usarlo: Una subida o copia WebDAV cuando el disco o la cuota del usuario están llenos.
Definido en RFC 4918
508
Loop Detected
El servidor detuvo una operación WebDAV porque encontró un bucle infinito.
Cuándo usarlo: Una petición con Depth: infinity a través de enlaces (bindings) que apuntan unos a otros.
Definido en RFC 5842
510
Not Extended
En desusoLa petición necesita extensiones adicionales que el servidor exige antes de atenderla.
Cuándo usarlo: Viene del HTTP Extension Framework (RFC 2774), que desde entonces pasó a estado histórico, y el registro marca el código como obsoleto. No lo envíes.
Definido en RFC 2774
511
Network Authentication Required
El cliente tiene que autenticarse para obtener acceso a la red.
Cuándo usarlo: Lo envían los portales cautivos, como las páginas de acceso al Wi-Fi de un hotel o un aeropuerto, que interceptan el tráfico hasta que el usuario inicia sesión.
Definido en RFC 6585