Códigos de respuesta del servidor: lista completa

Cuando un navegador o un robot de búsqueda se pone en contacto con un servidor con una solicitud, recibe automáticamente un determinado código de estado como respuesta. Todos los códigos de estado HTTP son de tres dígitos y pueden ir del 100 al 526. La gama se amplía ocasionalmente para describir algunos estados nuevos, pero esto ocurre raramente, por lo que los códigos de respuesta del servidor descritos en este artículo serán suficientes en el 99% de los casos.

Grupos de respuesta del servidor

Hay cinco categorías de respuestas:

1. De información (Informational) - en el rango de 100 a 105.
2. Exitosos (Success) - rango de 200 a 226.
3. De redirección (Redirection) - rango de 300 a 307.
4. Error del cliente (Client Error) - rango de 400 a 499.
5. Error del servidor (Server Error) - de 500 a 526.

Veamos con más detalle los códigos más comunes en cada una de estas categorías.

1xx: grupo de respuesta de información

1. Código de respuesta Transcripción de la respuesta Versión HTTP
2. 100 «Continue» Informa de que el servidor ha aceptado la solicitud y ha iniciado su procesamiento. Es decir, se permite al cliente seguir reenviando cabeceras. HTTP/1.1
3. 101 «Switching Protocols» Este código de respuesta del servidor indica que la conexión TCP debe utilizarse para otro protocolo. El campo de cabecera Update también especifica necesariamente varios protocolos adecuados. HTTP/1.1
4. 102 «Processing» Indica que la solicitud ha sido aceptada con éxito, pero también indica que el proceso tardará bastante más de lo habitual. Si ve un código como éste, no se apresure a romper la conexión con el servidor, sino que espere hasta que se haya procesado. HTTP/1.1
5. 103 «Early Hints» Este código proporciona un retorno anticipado de la meta-información - parte de las cabeceras. Se utiliza en situaciones en las que no se pueden generar rápidamente cabeceras de respuesta completas. HTTP/1.1

No es necesario enviar nada al servidor en respuesta a los códigos de información, sólo son necesarios para informar a la parte receptora de su estado.

2xx: grupo de respuestas exitosas

1. Código de respuesta Transcripción de la respuesta Versión HTTP
2. 200 «OK» Le informa de que la solicitud ha sido procesada con éxito. Si el cliente solicitó datos, éstos pueden verse en la cabecera recibida o en el cuerpo de la respuesta. HTTP/1.0 y más recientes
3. 201 «Created» Informa de una solicitud exitosa para crear un nuevo recurso. La dirección del nuevo recurso se adjunta al cuerpo de la respuesta. HTTP/1.0 y más recientes
4. 202 «Accepted» Aceptar una solicitud para su tramitación sin haberla completado definitivamente. El cliente puede no esperar a que el mensaje se transmita por completo, ya que este proceso puede llevar mucho tiempo. HTTP/1.0 y más recientes
5. 203 «Non-Authoritative Information» Este código de respuesta del servidor es similar al 200 "OK" con la diferencia de que la información no es tomada de la fuente y por lo tanto su relevancia es cuestionable. HTTP/1.0 y HTTP/1.1
6. 204 «No Content» La solicitud se procesa con éxito, pero el cliente sólo recibe las cabeceras sin el contenido. Las propias cabeceras pueden utilizarse para actualizar los metadatos. HTTP/1.0 y más recientes
7. 205 «Reset Content» Sólo en HTTP/1.1
8. 206 «Partial Content» Señala que una solicitud GET se ha ejecutado parcialmente. En esta respuesta la cabecera Content-Range contendrá uno o más rangos de bytes de contenido. Sólo en HTTP/1.1
9. 207 «Multi-Status» Indica que el servidor está transmitiendo los resultados de varias operaciones independientes al mismo tiempo. Aparece en WebDAV

3xx: mensajes de redirección

Este grupo de respuestas del servidor le informa de que es necesario iniciar otra petición a una URL específica para que la operación continúe. La URL adecuada puede leerse en la cabecera Location.

1. Código de respuesta Transcripción de la respuesta Versión HTTP
2. 300 «Multiple Choice» Para una URL determinada, existen varias opciones para proporcionar un recurso por tipo MIME, idioma u otros criterios. En el cuerpo de la respuesta, el servidor envía una lista de posibles respuestas, entre las que el cliente debe elegir la más adecuada. Esto se utiliza raramente, ya que no existe un método unificado para seleccionar una única respuesta. HTTP/1.0 y más recientes
3. 301 «Moved Permanently» El documento solicitado se traslada permanentemente a la nueva URL. La dirección en sí se especifica en el campo Ubicación. HTTP/1.0 y más recientes
4. 302 «Found» Informa de la disponibilidad temporal del documento solicitado en la URL especificada, que también puede leerse en el campo Ubicación. HTTP/1.0 y más recientes
5. 303 «See Other» Este código de respuesta del servidor es para redirigir al cliente a otra URL. Se envía si el documento solicitado está disponible temporalmente en una URL diferente. HTTP/1.1 y más recientes
6. 304 «Not Modified» El servidor envía este código cuando un cliente solicita un documento vía GET utilizando la cabecera If-Modified-Since o If-None-Match. El mensaje del servidor no debe contener un cuerpo. Para ver el documento de interés, envíe la solicitud a otra URL especificada en la cabecera Location. HTTP/1.0 y más recientes
7. 305 «Use Proxy» La petición al recurso de interés debe hacerse a través de un servidor proxy, cuya dirección puede encontrarse en la línea de cabecera Location de la respuesta del servidor. HTTP/1.1 y más recientes
8. 306 «Switch Proxy» La petición al recurso debe realizarse a través del proxy especificado por el servidor en la cabecera de respuesta. Hasta la fecha, el código no se ha utilizado. Sólo en HTTP/1.1
9. 307 «Temporary Redirect» Informa de que el recurso solicitado ha sido trasladado temporalmente a la URL especificada en la cabecera Location. Introducido en el RFC 2616 con la actualización de HTTP/1.1
10. 308 «Permanent Redirect» Informa de que el recurso solicitado ha sido trasladado de forma permanente, es decir, de forma definitiva, a la URL especificada en la cabecera Location. Introducido en el RFC 7238

4xx: grupo de respuesta de error del cliente

Los códigos de este grupo informan de los errores del lado del cliente. Suele haber una explicación hipertextual en el cuerpo del mensaje para el usuario. Veamos las principales.

1. Código de respuesta Transcripción de la respuesta Versión HTTP
2. 400 «Bad Request» Se ha detectado un error de sintaxis en la solicitud del cliente. HTTP/1.0 y superior
3. 401 «Unauthorized» Para acceder al recurso, debe estar autentificado. HTTP/0.9 y superior
4. 402 «Payment Required» Dicha respuesta puede recibirse de un servidor con un servicio de usuario de pago. HTTP/0.9 и 1.1
5. 403 «Forbidden» La solicitud no puede ser atendida debido a las restricciones establecidas por el nivel de acceso. En términos sencillos, una solicitud de un cliente no puede ser satisfecha debido a las restricciones establecidas por el administrador o el desarrollador de software. HTTP/1.0 y superior
6. 404 «Not Found» El legendario y conocido error que se produce cuando no hay ningún recurso en la URL solicitada. HTTP/1.0 y superior
7. 405 «Method Not Allowed» El método del cliente no puede aplicarse a este recurso debido a la desactivación manual. Este código de respuesta del servidor puede ser devuelto al cliente en respuesta a los intentos de acceder a los recursos a través de los métodos GET o HEAD. HTTP/1.1 y superior
8. 406 «Not Acceptable» La URL solicitada no coincide con las características pasadas en la cabecera. Puede leer la lista de características válidas en la respuesta del servidor. HTTP/1.1 y superior
9. 407 «Proxy Authentication Required» Para acceder al recurso, es necesario autenticarse en el servidor proxy. HTTP/1.1 y superior
10. 408 «Request Timeout» Se emite cuando el servidor está esperando una respuesta del cliente para expirar. A menudo se encuentra en sitios web con autenticación de dos factores, sistemas de pago y otros recursos en los que se debe recibir una respuesta del cliente a una solicitud en un tiempo limitado. HTTP/1.1 y superior
11. 409 «Conflict» Informa de la imposibilidad de ejecutar la solicitud debido a una solicitud conflictiva. Por ejemplo, si un cliente intenta modificar un recurso de cualquier manera utilizando el comando PUT. HTTP/1.1 y superior
12. 410 «Gone» Se envía cuando un recurso que estaba previamente en la URL especificada se ha movido a una dirección diferente. La nueva dirección no es conocida por el servidor. HTTP/1.1 y superior
13. 411 «Length Required» El cliente debe especificar el Content-Length en la cabecera de la petición y luego contactar de nuevo con el servidor. HTTP/1.1 y superior
14. 412 «Precondition Failed» El cliente ha especificado condiciones en sus cabeceras que el servidor no puede cumplir. HTTP/1.1 y superior
15. 413 «Payload Too Large» Informa de que se ha superado el tamaño permitido del cuerpo de la solicitud. HTTP/1.1 y superior
16. 414 «URI Too Long» El cliente ha especificado una URL demasiado larga. Si está utilizando el método GET para pasar los parámetros, debería probar con POST. HTTP/1.1 y superior
17. 415 «Unsupported Media Type» El servidor se niega a procesar datos de este tipo dentro del método aplicado. Puede probar otro método. HTTP/1.1 y superior
18. 416 «Range Not Satisfiable» El rango especificado en la cabecera Range no puede ser ejecutado. Cuando se transmiten rangos de bytes el servidor responderá con el tamaño real en el campo Content-Range de la cabecera, esto se puede utilizar cuando se transmiten tipos multipart/byteranges. HTTP/1.1 y superior
19. 417 «Expectation Failed» Los datos del campo Expect no satisfacen los requisitos del servidor, por lo que la solicitud no puede ejecutarse. HTTP/1.1 y superior
20. 418 «I’m a teapot» Un código de broma originado en 1998. No es compatible con los servidores modernos.
21. 419 «Authentication Timeout» Se utiliza como alternativa a un 401 cuando se pasa la autenticación pero el cliente no accede a ciertos recursos en el servidor. HTTP/1.1 y superior
22. 421 «Misdirected Request» El servidor informa de un intento fallido de redirigir la petición a otro servidor, que no puede responder.
23. 422 «Unprocessable Entity» Le informa de que la solicitud ha sido aceptada con éxito y que los tipos de datos especificados han sido reconocidos. Al mismo tiempo, debido a un cierto error lógico, no puede realizar la operación. Introducido en WebDAV
24. 423 «Locked» No se puede acceder al recurso solicitado porque el método utilizado no le corresponde. Introducido en WebDAV
25. 424 «Failed Dependency» Informa de que la solicitud no puede ejecutarse porque la operación anterior de la que dependía la solicitud aún no ha finalizado. Introducido en WebDAV
26. 425 «Too Early» El servidor se niega a asumir el riesgo de procesar "información temprana". Introducido en el RFC 8470 para proporcionar protección contra ataques de repetición cuando se utiliza 0-RTT en TLS 1.3
27. 426 «Upgrade Required» El cliente necesita actualizar el protocolo. Los detalles se encuentran en los campos Actualización y Conexión. Introducido en el RFC 2817 para permitir la migración a TLS sobre HTTP
28. 428 «Precondition Required» Le indica que utilice cabeceras de condición como If-Match en la solicitud Introducido en el RFC 6585
29. 429 «Too Many Requests» El cliente intenta enviar demasiadas peticiones en un corto periodo de tiempo. El código de error está destinado a la protección contra los DDoS. También puede ver en el cuerpo del mensaje el tiempo después del cual será posible reenviar la solicitud. Introducido en el RFC 6585
30. 431 «Request Header Fields Too Large» Informa de que la longitud de la cabecera ha superado la longitud permitida. Introducido en el RFC 6585
31. 434 «Requested host unavailable» Indica que la dirección solicitada no está disponible.
32. 449 «Retry With» El servidor necesita más información para satisfacer la solicitud.
33. 451 «Unavailable For Legal Reasons» Un recurso objetivo es inaccesible debido a los procedimientos legales. Es posible que se enfrente a un sitio web bloqueado por una orden judicial o por las autoridades policiales.

5xx: grupo de respuesta de error del servidor

Este grupo de respuestas del servidor informa de los casos de excepciones no controladas detectadas al intentar ejecutar una operación del lado del servidor.

1. Código de respuesta Transcripción de la respuesta Versión HTTP
2. 500 «Internal Server Error» Informa de un error interno del servidor que está fuera del alcance de los otros errores de este grupo. HTTP/1.0 y superior
3. 501 «Not Implemented» El servidor no puede procesar la solicitud porque no entiende el método especificado. Si el servidor entiende el método pero se niega a ejecutar la solicitud debido a restricciones internas, se emite un código "405". HTTP/1.0 y superior
4. 502 «Bad Gateway» Se emite si la solicitud se envía a un servidor proxy o de pasarela. Normalmente, el servidor "intermedio" intentará redirigir la petición al servidor anterior, y si recibe una respuesta no válida, el cliente recibirá el error 502. HTTP/1.0 y superior
5. 503 «Service Unavailable» El servidor no puede procesar temporalmente las solicitudes debido al mantenimiento o al reinicio. HTTP/1.0 y superior
6. 504 «Gateway Timeout» Actuando como puerta de enlace o servidor proxy, el servidor no ha recibido una respuesta del servidor ascendente durante algún tiempo. HTTP/1.1 y superior
7. 505 «HTTP Version Not Supported» El servidor no soporta la versión especificada del protocolo HTTP. HTTP/1.1 y superior
8. 507 «Insufficient Storage» Le informa de que no hay espacio suficiente en el servidor para completar la operación. Introducido en WebDAV
9. 508 «Loop Detected» La operación se ha abortado porque se ha detectado un bucle infinito al procesar una consulta sin límite de profundidad. Introducido en WebDAV
10. 509 «Bandwidth Limit Exceeded» Se emite si el sitio web ha superado su límite de tráfico. Si este es el caso, debe ponerse en contacto con su proveedor de alojamiento directamente.
11. 510 «Not Extended» El servidor no dispone de la extensión que el cliente intenta utilizar en su petición. Normalmente, la respuesta del servidor contiene datos sobre las extensiones disponibles en el lado del servidor.
12. 511 «Network Authentication Required» Le avisa de que es necesaria una autorización para poder ejecutar la solicitud especificada. Introducido por el RFC 6585
13. 520 «Unknown Error» El servidor CDN no puede manejar el error del servidor.
14. 521 «Web Server Is Down» El servidor web rechaza la conexión CDN.
15. 522 «Connection Timed Out» El CDN no puede conectarse al servidor web.
16. 525 «SSL Handshake Failed» Error de handshake SSL entre el servidor web y el servidor CDN.
17. 526 «Invalid SSL Certificate» Intento fallido de validar el certificado de cifrado SSL.