Referencia de códigos de estado HTTP
Consulta qué significa un código de estado HTTP.
| 100 | Continue | Se ha recibido la parte inicial de la solicitud y el cliente debe continuar enviando el resto. |
| 101 | Switching Protocols | El servidor está cambiando de protocolo según lo solicitado por el cliente, por ejemplo, actualizando a WebSocket. |
| 102 | Processing | El servidor ha aceptado la solicitud completa pero aún no ha terminado de procesarla (WebDAV). |
| 103 | Early Hints | Permite que el cliente empiece a precargar recursos mientras el servidor aún prepara la respuesta final. |
| 200 | OK | La solicitud se completó con éxito y el cuerpo de la respuesta contiene el recurso solicitado. |
| 201 | Created | La solicitud se completó con éxito y, como resultado, se creó un nuevo recurso. |
| 202 | Accepted | La solicitud ha sido aceptada para su procesamiento, pero este aún no se ha completado. |
| 203 | Non-Authoritative Information | Los metadatos devueltos no provienen del servidor de origen, sino de una copia de un tercero o de la caché local. |
| 204 | No Content | La solicitud se completó con éxito, pero no hay contenido que devolver. |
| 205 | Reset Content | La solicitud se completó con éxito; el cliente debe restablecer la vista del documento que la envió. |
| 206 | Partial Content | Solo se está entregando una parte del recurso, en respuesta a una solicitud de rango de bytes. |
| 207 | Multi-Status | Transmite información sobre varios recursos en situaciones donde podrían ser apropiados varios códigos de estado (WebDAV). |
| 208 | Already Reported | Los miembros de un enlace WebDAV ya se han enumerado en una parte anterior de la respuesta. |
| 226 | IM Used | El servidor ha satisfecho una solicitud utilizando una o más manipulaciones de instancia. |
| 300 | Multiple Choices | La solicitud tiene más de una respuesta posible; el cliente debe elegir una. |
| 301 | Moved Permanently | El recurso se ha trasladado permanentemente a una nueva URL indicada en la respuesta. |
| 302 | Found | El recurso reside temporalmente en una URL diferente; las futuras solicitudes deben seguir usando la URL original. |
| 303 | See Other | La respuesta se puede encontrar en otra URL utilizando una solicitud GET. |
| 304 | Not Modified | El recurso no ha cambiado desde la versión especificada en las cabeceras de caché del cliente. |
| 307 | Temporary Redirect | El recurso reside temporalmente en una URL diferente; a diferencia de 302, se debe reutilizar el método de solicitud original. |
| 308 | Permanent Redirect | El recurso se ha trasladado permanentemente a una nueva URL; se debe reutilizar el método de solicitud original. |
| 400 | Bad Request | El servidor no pudo entender la solicitud debido a una sintaxis no válida. |
| 401 | Unauthorized | Se requiere autenticación, que ha fallado o no se ha proporcionado. |
| 402 | Payment Required | Reservado para uso futuro; originalmente pensado para sistemas de pago digital. |
| 403 | Forbidden | El cliente no tiene derechos de acceso al contenido, aunque la solicitud se haya entendido. |
| 404 | Not Found | El servidor no puede encontrar el recurso solicitado. |
| 405 | Method Not Allowed | El método de solicitud es conocido pero no es compatible con el recurso de destino. |
| 406 | Not Acceptable | El servidor no puede generar una respuesta que coincida con las cabeceras Accept del cliente. |
| 407 | Proxy Authentication Required | Se requiere autenticación con un proxy antes de que la solicitud pueda continuar. |
| 408 | Request Timeout | El servidor agotó el tiempo de espera de la solicitud del cliente. |
| 409 | Conflict | La solicitud entra en conflicto con el estado actual del recurso de destino. |
| 410 | Gone | El recurso solicitado ya no está disponible y ha sido eliminado permanentemente. |
| 411 | Length Required | El servidor requiere una cabecera Content-Length que faltaba en la solicitud. |
| 412 | Precondition Failed | El servidor no cumplió con una condición previa especificada en las cabeceras de la solicitud. |
| 413 | Payload Too Large | El cuerpo de la solicitud es mayor de lo que el servidor está dispuesto o es capaz de procesar. |
| 414 | URI Too Long | El URI solicitado es más largo de lo que el servidor está dispuesto a interpretar. |
| 415 | Unsupported Media Type | El formato multimedia de la solicitud no es compatible con el servidor. |
| 416 | Range Not Satisfiable | El rango de bytes solicitado no se puede satisfacer dado el tamaño del recurso. |
| 417 | Expectation Failed | El servidor no puede cumplir con la expectativa indicada en la cabecera Expect de la solicitud. |
| 418 | I'm a Teapot | Un estado jocoso definido como broma del Día de los Inocentes en el RFC 2324; los servidores no deberían preparar café. |
| 421 | Misdirected Request | La solicitud se envió a un servidor que no puede producir una respuesta para el URI de destino. |
| 422 | Unprocessable Content | La solicitud tenía un formato correcto, pero contiene errores semánticos que impiden su procesamiento. |
| 423 | Locked | El recurso al que se intenta acceder está bloqueado (WebDAV). |
| 424 | Failed Dependency | La solicitud falló porque dependía de otra solicitud que también falló (WebDAV). |
| 425 | Too Early | El servidor no está dispuesto a procesar una solicitud que podría ser reproducida (replay). |
| 426 | Upgrade Required | El cliente debe cambiar a un protocolo diferente indicado en la cabecera Upgrade. |
| 428 | Precondition Required | El servidor de origen requiere que la solicitud sea condicional. |
| 429 | Too Many Requests | El cliente ha enviado demasiadas solicitudes en un período de tiempo determinado (limitación de tasa). |
| 431 | Request Header Fields Too Large | El servidor no procesará la solicitud porque sus campos de cabecera son demasiado grandes. |
| 451 | Unavailable For Legal Reasons | El recurso no está disponible por motivos legales, como una censura exigida por el gobierno. |
| 500 | Internal Server Error | El servidor encontró una condición inesperada que le impidió completar la solicitud. |
| 501 | Not Implemented | El servidor no admite la funcionalidad necesaria para completar la solicitud. |
| 502 | Bad Gateway | El servidor, actuando como puerta de enlace, recibió una respuesta no válida de un servidor ascendente. |
| 503 | Service Unavailable | El servidor no está listo para gestionar la solicitud, a menudo debido a mantenimiento o sobrecarga. |
| 504 | Gateway Timeout | El servidor, actuando como puerta de enlace, no recibió una respuesta a tiempo de un servidor ascendente. |
| 505 | HTTP Version Not Supported | La versión de HTTP utilizada en la solicitud no es compatible con el servidor. |
| 506 | Variant Also Negotiates | El servidor tiene un error de configuración interna en la negociación de contenido. |
| 507 | Insufficient Storage | El servidor no puede almacenar la representación necesaria para completar la solicitud (WebDAV). |
| 508 | Loop Detected | El servidor detectó un bucle infinito al procesar la solicitud (WebDAV). |
| 510 | Not Extended | Se requieren extensiones adicionales a la solicitud para que el servidor pueda satisfacerla. |
| 511 | Network Authentication Required | El cliente necesita autenticarse para obtener acceso a la red, algo habitual en portales cautivos. |
Ejemplos de uso
Entender qué significa el código de estado de una respuesta de API
Busca un código poco familiar como el 422 devuelto por una API de backend para ver rápidamente qué significa y cómo responder a él.
Elegir el código de redirección correcto
Consulta la diferencia entre 301 y 308, o entre 302 y 307, para decidir qué estado de redirección usar al mover una URL.
Buscar un código visto en la pestaña de red del navegador
Busca un código de estado que hayas visto en la pestaña de red de las herramientas de desarrollador de tu navegador para entender por qué falló una solicitud.
Distinguir 401 de 403 al depurar la autenticación
Busca «401» y «403» uno junto al otro para ver la distinción exacta: 401 significa que la petición no tiene credenciales válidas, mientras que 403 significa que las credenciales son válidas pero el usuario no tiene permiso para acceder al recurso.
Decidir cómo gestionar la limitación de tasa en un cliente
Busca 429 para confirmar que significa demasiadas peticiones en un tiempo dado y comprueba si la respuesta de tu API incluye una cabecera Retry-After que debas respetar antes de reintentar.
Preguntas frecuentes
¿Todos los códigos de esta lista son realmente estándar?
Sí: esta lista solo incluye códigos registrados en el registro oficial de códigos de estado HTTP de la IANA que están en uso común. No se incluyen códigos no estándar o no oficiales.
¿Por qué faltan códigos como el 305 y el 306?
El 305 (Use Proxy) está prácticamente obsoleto por motivos de seguridad, y el 306 no se usa. Como es muy poco probable que te encuentres con ellos en la práctica, la lista se centra en los códigos con los que realmente te toparás.
¿Estas descripciones sustituyen la especificación completa o el asesoramiento legal?
No: son resúmenes breves pensados para una consulta rápida. Si el comportamiento exacto es importante, consulta directamente el RFC correspondiente o la especificación HTTP vigente.
¿Cuál es la diferencia real entre 401 y 403?
401 Unauthorized significa en realidad «no autenticado»: el servidor no sabe quién eres, normalmente porque faltan credenciales o no son válidas. 403 Forbidden significa que el servidor sabe quién eres pero no tienes permiso para acceder a ese recurso, incluso con credenciales válidas.
¿Debo usar 404 o 410 cuando un recurso ya no está?
Usa 404 Not Found cuando un recurso no existe y no sabes (o no quieres decir) si alguna vez existió. Usa 410 Gone cuando sabes con certeza que un recurso existía pero se ha eliminado de forma permanente: indica a los clientes y a los motores de búsqueda que dejen de solicitarlo.
¿Cuándo debo usar 301, 302, 307 o 308 en una redirección?
301 y 308 son redirecciones permanentes; 302 y 307 son temporales. La diferencia entre el par más antiguo (301/302) y el más nuevo (307/308) es que 307 y 308 garantizan que el método y el cuerpo de la petición se conservan en la petición redirigida, mientras que 301 y 302 históricamente permiten a los clientes cambiar un POST por un GET.
¿Por qué mi servidor devolvió un 500 en lugar de un código más específico?
500 Internal Server Error es un comodín genérico para fallos inesperados del lado del servidor, como una excepción no controlada. Normalmente significa que el manejo de errores del servidor no asignó el fallo a un código 4xx o 5xx más específico: revisa los registros de tu servidor para ver la causa real.