Códigos de Estado HTTP
Una referencia con búsqueda de los códigos de estado de respuesta HTTP.
- 100 Continue
El servidor recibió las cabeceras y el cliente debe enviar el cuerpo. Se usa con la cabecera Expect: 100-continue.
- 101 Switching Protocols
El servidor acepta cambiar de protocolo según lo pedido, normalmente para pasar una conexión a WebSocket.
- 102 Processing
El servidor aceptó la petición pero aún no la ha terminado. Aparece en WebDAV.
- 103 Early Hints
Permite al navegador empezar a precargar recursos mientras el servidor prepara la respuesta final.
- 200 OK
La petición tuvo éxito. El significado depende del método: GET devuelve el recurso, POST devuelve el resultado de la acción.
- 201 Created
La petición tuvo éxito y se creó un recurso nuevo, normalmente tras un POST o PUT. Una cabecera Location suele apuntar a él.
- 202 Accepted
La petición se aceptó para procesarla, pero el trabajo no ha terminado. Habitual en tareas asíncronas y colas.
- 203 Non-Authoritative Information
La respuesta viene de un proxy o de una copia transformada, no del servidor de origen.
- 204 No Content
La petición tuvo éxito y no hay cuerpo que devolver. Típico en DELETE y en actualizaciones que no necesitan datos de respuesta.
- 205 Reset Content
La petición tuvo éxito y el cliente debe restablecer la vista, por ejemplo vaciar un formulario.
- 206 Partial Content
El servidor devuelve solo una parte del recurso por una cabecera Range. Se usa en descargas reanudables y al saltar en vídeos.
- 207 Multi-Status
Una respuesta WebDAV que lleva códigos de estado separados para varias suboperaciones.
- 226 IM Used
El servidor cumplió un GET aplicando manipulaciones de instancia, como la codificación delta.
- 300 Multiple Choices
Hay varias respuestas posibles para la petición y el cliente debe elegir una. Se usa poco en la práctica.
- 301 Moved Permanently
El recurso tiene una nueva URL permanente. Los buscadores transfieren el posicionamiento a la nueva dirección. Úsalo en redirecciones permanentes.
- 302 Found
Una redirección temporal. El cliente debe seguir usando la URL original en peticiones futuras.
- 303 See Other
Redirige a otra URL que debe pedirse con GET, normalmente tras un POST de formulario (Post/Redirect/Get).
- 304 Not Modified
La copia en caché sigue siendo válida, así que no se envía cuerpo. Se devuelve en peticiones condicionales con If-None-Match o If-Modified-Since.
- 307 Temporary Redirect
Una redirección temporal que mantiene el método y el cuerpo de la petición, a diferencia del 302 en algunos clientes antiguos.
- 308 Permanent Redirect
Una redirección permanente que mantiene el método y el cuerpo de la petición. La versión del 301 que conserva el método.
- 400 Bad Request
El servidor no puede procesar la petición por sintaxis mal formada, parámetros no válidos o un cuerpo no válido. Revisa el formato de la petición.
- 401 Unauthorized
Falta la autenticación o no es válida. El cliente debe iniciar sesión o enviar credenciales válidas. A pesar del nombre, se refiere a la autenticación.
- 402 Payment Required
Reservado para sistemas de pago digital. Algunas API lo usan cuando se alcanza el límite de un plan o se requiere un pago.
- 403 Forbidden
El servidor entendió la petición pero se niega a autorizarla. Se conoce la identidad pero no tiene permiso, o una regla bloquea el acceso.
- 404 Not Found
El servidor no encuentra el recurso pedido. Las causas habituales son una URL errónea, una página eliminada o una ruta inexistente.
- 405 Method Not Allowed
El método HTTP no se admite para esta URL, por ejemplo un POST a un endpoint de solo lectura. La cabecera Allow lista los métodos válidos.
- 406 Not Acceptable
El servidor no puede producir una respuesta que coincida con las cabeceras Accept enviadas por el cliente.
- 407 Proxy Authentication Required
Como el 401, pero el cliente debe autenticarse primero ante el proxy.
- 408 Request Timeout
El servidor agotó el tiempo esperando a que el cliente terminara de enviar la petición.
- 409 Conflict
La petición entra en conflicto con el estado actual del recurso, como un conflicto de edición o un valor único duplicado.
- 410 Gone
El recurso se eliminó de forma permanente y no volverá. Los buscadores lo retiran más rápido que con un 404.
- 411 Length Required
El servidor exige una cabecera Content-Length y la petición no la incluía.
- 412 Precondition Failed
Una condición de las cabeceras de la petición, como If-Match, resultó falsa.
- 413 Content Too Large
El cuerpo de la petición es mayor de lo que permite el servidor. Sube el límite de carga o envía un archivo más pequeño.
- 414 URI Too Long
La URL es más larga de lo que el servidor acepta, a menudo por una cadena de consulta muy larga.
- 415 Unsupported Media Type
El servidor no admite el formato de la cabecera Content-Type. Comprueba que envías el tipo esperado, como application/json.
- 416 Range Not Satisfiable
La cabecera Range pide una porción que el recurso no tiene.
- 417 Expectation Failed
El servidor no puede cumplir el requisito de la cabecera Expect.
- 418 I'm a teapot
Una broma del 1 de abril de la RFC 2324. Algunos servicios lo devuelven a propósito para rechazar una petición.
- 421 Misdirected Request
La petición se envió a un servidor que no puede responder para ese host.
- 422 Unprocessable Content
La sintaxis es correcta pero los datos no son válidos semánticamente, por ejemplo una validación fallida. Muy común en las API REST.
- 423 Locked
El recurso está bloqueado. Aparece en WebDAV.
- 424 Failed Dependency
La petición falló porque falló otra anterior de la que dependía.
- 425 Too Early
El servidor se niega a procesar una petición que podría repetirse.
- 426 Upgrade Required
El cliente debe cambiar a otro protocolo, indicado en la cabecera Upgrade.
- 428 Precondition Required
El servidor exige que la petición sea condicional para evitar actualizaciones perdidas.
- 429 Too Many Requests
El cliente envió demasiadas peticiones en un tiempo dado (límite de tasa). Una cabecera Retry-After puede indicar cuándo reintentar.
- 431 Request Header Fields Too Large
Las cabeceras, a menudo las cookies, son demasiado grandes para que el servidor las acepte.
- 451 Unavailable For Legal Reasons
El acceso se deniega por motivos legales, como una orden judicial o censura.
- 500 Internal Server Error
Un fallo genérico del lado del servidor. Revisa los registros del servidor en busca de una excepción no controlada o un error de configuración.
- 501 Not Implemented
El servidor no admite la funcionalidad necesaria para cumplir la petición.
- 502 Bad Gateway
Una pasarela o proxy recibió una respuesta no válida del servidor ascendente. A menudo la aplicación detrás de un proxy inverso está caída.
- 503 Service Unavailable
El servidor no puede atender la petición temporalmente por sobrecarga o mantenimiento. Retry-After puede sugerir cuándo.
- 504 Gateway Timeout
Una pasarela o proxy no recibió a tiempo una respuesta del servidor ascendente. Busca consultas lentas o peticiones muy largas.
- 505 HTTP Version Not Supported
El servidor no admite la versión de HTTP usada en la petición.
- 507 Insufficient Storage
El servidor no puede almacenar los datos necesarios para completar la petición. Aparece en WebDAV.
- 508 Loop Detected
El servidor detectó un bucle infinito al procesar la petición.
- 511 Network Authentication Required
El cliente debe autenticarse para acceder a la red, por ejemplo en un portal cautivo.
¿Qué son los códigos de estado HTTP?
Toda respuesta HTTP empieza con un código de estado de tres dígitos que indica al cliente cómo fue la petición. El primer dígito da la clase: 1xx para mensajes informativos, 2xx para éxito, 3xx para redirección, 4xx para errores causados por el cliente y 5xx para errores del servidor. Los navegadores, los buscadores, las API y las herramientas de monitorización se basan en estos códigos para decidir qué hacer a continuación.
Elegir el código correcto importa. Un 301 transfiere el posicionamiento a una nueva URL mientras que un 302 no, un 404 y un 410 dicen cosas distintas a los rastreadores sobre una página que falta, y un 429 pide a los clientes de una API que reduzcan el ritmo. Esta referencia lista los códigos que encontrarás con más frecuencia, con una explicación breve y la causa habitual, para que depures más rápido y diseñes API más claras.
Cómo usar la referencia
- Escribe un código, un nombre o una palabra como redirect o timeout.
- Filtra por clase para ver solo los códigos de éxito, redirección, error del cliente o error del servidor.
- Lee la explicación para entender qué significa el código y qué suele causarlo.
Casos de uso comunes
- Depuración - averigua qué significa realmente un 502 o un 504 de un servidor.
- Diseño de API - elige el código más preciso para cada respuesta.
- SEO - elige la redirección o el código de error adecuado para páginas movidas y eliminadas.