¿Qué es un código de estado HTTP?
Un código de estado HTTP es una respuesta de tres dígitos que envía un servidor web para indicar el resultado de la solicitud de un cliente. Ayuda tanto a los navegadores como a los desarrolladores a saber si una solicitud se ha realizado con éxito, ha fallado o requiere alguna acción adicional.
Cada vez que un cliente (como un navegador, una API o un proxy) envía una solicitud a un servidor web, este responde con un código de estado que describe cómo ha gestionado dicha solicitud.
Estos códigos se agrupan en cinco categorías principales en función de su primer dígito:
- 1xx — Informativo: Se ha recibido la solicitud y se está tramitando.
- 2xx — Éxito: La solicitud se ha recibido, comprendido y aceptado correctamente.
- 3xx — Redirección: El cliente debe realizar algún trámite adicional para completar la solicitud.
- 4xx — Errores del cliente: La solicitud presenta un error de sintaxis o no puede atenderse.
- 5xx — Errores del servidor: El servidor no ha podido atender una solicitud válida.
Para los usuarios de un proxy, estos códigos proporcionan información fundamental para determinar si un problema de conexión se debe al proxy, al sitio web de destino o a la red intermedia.
1xx – Informativo
| Código de estado | Definición | Próximos pasos |
|---|---|---|
| 100 Continuar | Se ha recibido la parte inicial de una solicitud, y el cliente debe continuar con la misma. | Continúe enviando la solicitud. |
| 101 Protocolos de conmutación | El servidor está cambiando a un protocolo diferente, tal y como ha solicitado el cliente. | Asegúrese de que el cliente sea compatible con el nuevo protocolo. |
| 102 En proceso | El servidor ha recibido la solicitud y la está procesando, pero aún no hay ninguna respuesta disponible. | Espere a que el servidor termine el procesamiento. |
| 103 Pistas iniciales | Proporciona información preliminar sobre la solicitud, normalmente con el fin de optimizar la carga. | Aproveche estos consejos para mejorar el rendimiento o la experiencia del usuario. |
2xx - Éxito
| Código de estado | Definición | Próximos pasos |
|---|---|---|
| 200 OK | La solicitud se ha realizado correctamente y el servidor ha devuelto el recurso solicitado. | No es necesario realizar ninguna acción; la solicitud se ha procesado correctamente. |
| 201 Creado | La solicitud se ha tramitado, lo que ha dado lugar a la creación de un nuevo recurso. | No es necesario realizar ninguna acción adicional; se ha creado un nuevo recurso. |
| 202 Aceptado | La solicitud se ha aceptado para su tramitación, pero el proceso aún no ha finalizado. | Espere a que finalice el proceso; compruebe si hay actualizaciones, si es necesario. |
| 203 Información no oficial | La solicitud se ha realizado correctamente, pero es posible que los metadatos devueltos no procedan del servidor original. | Revise los datos obtenidos para asegurarse de que cumplen los requisitos. |
| 204 Sin contenido | La solicitud se ha realizado correctamente, pero la respuesta no contiene ningún contenido. | No es necesario realizar ninguna acción; la solicitud se ha realizado correctamente, pero no hay contenido que mostrar. |
| 205 Restablecer contenido | La solicitud se ha realizado correctamente y el cliente debería actualizar la vista. | Restablezca la vista del documento o el formulario a su estado original. |
| 206 Contenido parcial | El servidor devuelve contenido parcial del recurso solicitado, normalmente debido a un encabezado «range». | Siga solicitando más contenido según sea necesario; compruebe los datos recibidos. |
3xx – Redirección
| Código de estado | Definición | Próximos pasos |
|---|---|---|
| 300 preguntas de opción múltiple | La solicitud tiene varias respuestas posibles. El usuario o el cliente debe elegir una de ellas. | Elija una de las opciones que se ofrecen o modifique la solicitud para que sea más específica. |
| 301 Desplazado de forma permanente | El recurso solicitado se ha trasladado a una nueva URL, por lo que todas las solicitudes futuras deberán utilizar la nueva URL. | Actualice los marcadores o las referencias para utilizar la nueva URL. |
| 302 Encontrado | El recurso solicitado se encuentra temporalmente en una URL diferente, pero el cliente debe seguir utilizando la URL original para futuras solicitudes. | Siga la URL temporal, pero siga utilizando la URL original para futuras solicitudes. |
| 303 Ver más | La respuesta a la solicitud se puede consultar en una URL diferente utilizando el método GET. | Realice una solicitud GET a la URL indicada para recuperar el recurso. |
| 304 No modificado | El recurso no se ha modificado desde la última solicitud, por lo que el cliente puede utilizar la versión almacenada en caché. | Utilice la versión almacenada en caché del recurso. |
| 305 Utilizar un proxy | Se debe acceder al recurso solicitado a través del proxy especificado en la respuesta. | Vuelva a enviar la solicitud utilizando el proxy indicado. |
| 307 Redirección temporal | El recurso solicitado se encuentra temporalmente en una URL diferente, y el cliente debe seguir dicha URL para esta solicitud. | Siga la URL temporal para esta solicitud, pero utilice la URL original para futuras solicitudes. |
| 308 Redirección permanente | El recurso solicitado se ha trasladado de forma permanente a una nueva URL, por lo que todas las solicitudes futuras deberán utilizar la nueva URL. | Actualice todas las referencias para que utilicen la nueva URL. |
4xx – Error del cliente
| Código de estado | Definición | Próximos pasos |
|---|---|---|
| 400 Solicitud incorrecta | El servidor no puede procesar la solicitud debido a un error del cliente (por ejemplo, una sintaxis de solicitud incorrecta). | Compruebe la sintaxis y los parámetros de la solicitud y, a continuación, inténtelo de nuevo. |
| 401 Acceso no autorizado | Se requiere autenticación para acceder al recurso solicitado. | Introduzca unas credenciales de autenticación válidas e inténtelo de nuevo. |
| 402 Se requiere pago | Reservado para uso futuro; suele indicar que es necesario realizar un pago para acceder al recurso. | Si procede, complete el proceso de pago. |
| 403 Prohibido | El servidor entiende la solicitud, pero se niega a autorizarla. | Asegúrese de que dispone de los permisos necesarios para acceder al recurso. |
| 404 No encontrado | El servidor no puede encontrar el recurso solicitado. | Compruebe si la URL contiene errores o intente buscar el recurso. |
| 405 Método no permitido | El método de solicitud no es compatible con el recurso solicitado. | Compruebe si se está utilizando el método HTTP correcto (GET, POST, etc.). |
| 406 No aceptable | El servidor no puede generar una respuesta que sea aceptable según los encabezados «Accept» del cliente. | Modifique los encabezados de la solicitud para que acepten un formato de respuesta válido. |
| 407 Se requiere autenticación de proxy | El cliente debe autenticarse primero con el proxy. | Introduzca unas credenciales de autenticación de proxy válidas. |
| Tiempo de espera de la solicitud 408 | El servidor ha agotado el tiempo de espera de la solicitud. | Vuelva a enviar la solicitud, asegurándose de que se envíe dentro del plazo permitido por el servidor. |
| 409 Conflicto | No se ha podido procesar la solicitud debido a un conflicto con el estado actual del recurso. | Resuelva el conflicto antes de volver a intentar la solicitud. |
| 410 Gone | El recurso solicitado ya no está disponible y no volverá a estarlo. | Elimine o actualice las referencias al recurso, ya que se ha eliminado de forma definitiva. |
| 411 Longitud requerida | El servidor requiere que la solicitud incluya el encabezado «Content-Length». | Incluya el encabezado «Content-Length» en la solicitud e inténtelo de nuevo. |
| 412 Error en la condición previa | El servidor no cumple una de las condiciones previas especificadas en los encabezados de la solicitud. | Revise los requisitos previos en los encabezados de la solicitud y modifíquelos según sea necesario. |
| 413 Carga útil demasiado grande | La entidad de la solicitud es más grande de lo que el servidor está dispuesto o es capaz de procesar. | Reduzca el tamaño de la carga útil de la solicitud e inténtelo de nuevo. |
| 414 URI demasiado largo | El URI solicitado por el cliente es más largo de lo que el servidor está dispuesto a interpretar. | Acorte la URI o reduzca la complejidad de la solicitud. |
| 415 Tipo de medio no admitido | El servidor no admite el formato multimedia de los datos solicitados. | Utilice un formato multimedia compatible en la solicitud. |
| 416 Rango no satisfactorio | El servidor no puede cumplir con el rango especificado en el encabezado «Range». | Modifique la solicitud de rango o intente acceder al recurso completo. |
| 417 Error en la expectativa | El servidor no puede cumplir los requisitos del campo de encabezado de solicitud «Expect». | Elimine el encabezado «Expect» o modifique su valor y vuelva a intentarlo. |
| 429 Demasiadas solicitudes | El usuario ha enviado demasiadas solicitudes desde la misma dirección IP en un periodo de tiempo determinado («limitación de frecuencia»). | Espere y vuelva a intentarlo más tarde; considere la posibilidad de reducir la frecuencia de las solicitudes o de distribuirlas entre varias direcciones IP mediante el uso de proxies residenciales. |
5xx – Error del servidor
| Código de estado | Definición | Próximos pasos |
|---|---|---|
| Error 500 del servidor interno | El servidor ha detectado una situación inesperada que le ha impedido atender la solicitud. | Compruebe los registros del servidor en busca de errores y solucione cualquier incidencia que esté provocando el problema. |
| 501 No implementado | El servidor no admite la funcionalidad necesaria para atender la solicitud. | Asegúrese de que el software del servidor sea capaz de gestionar la solicitud; considere la posibilidad de actualizar o sustituir el servidor. |
| 502 Error de puerta de enlace | El servidor, al actuar como puerta de enlace o proxy, recibió una respuesta no válida de un servidor de nivel superior. | Compruebe el servidor de origen y las conexiones de red; resuelva cualquier problema. |
| 503 Servicio no disponible | El servidor no puede atender la solicitud en este momento, a menudo debido a una sobrecarga temporal o a tareas de mantenimiento. | Inténtelo de nuevo más tarde; compruebe la carga del servidor o el estado de mantenimiento. |
| Tiempo de espera de la puerta de enlace 504 | El servidor, al actuar como puerta de enlace o proxy, no recibió una respuesta a tiempo de un servidor de nivel superior. | Compruebe el servidor de origen y las conexiones de red; asegúrese de que los ajustes de tiempo de espera sean los adecuados. |
| 505 Versión HTTP no compatible | El servidor no admite la versión del protocolo HTTP utilizada en la solicitud. | Utilice una versión de HTTP compatible o actualice el software del servidor. |
| La variante 506 también se transmite | El servidor presenta un error de configuración interna que provoca una referencia circular. | Corrija la configuración del servidor para resolver la referencia circular. |
| 507 Espacio de almacenamiento insuficiente | El servidor no puede almacenar la representación necesaria para completar la solicitud. | Libere espacio en disco o aumente la capacidad de almacenamiento del servidor. |
| Se ha detectado un bucle de 508 | El servidor ha detectado un bucle infinito durante el procesamiento de una solicitud. | Investigue y solucione el bucle en la configuración o el código del servidor. |
| 510 No ampliado | Se requieren más datos para que el servidor pueda atender la solicitud. | Asegúrese de que la solicitud del cliente incluya las extensiones necesarias. |
| Se requiere autenticación en la red 511 | El cliente debe autenticarse para obtener acceso a la red. | Introduzca unas credenciales de autenticación de red válidas. |
Casos de uso
Supervisión de las conexiones a través de un proxy
Al utilizar servidores proxy para la recopilación de datos En el caso de la automatización web, los códigos de estado revelan dónde se ha producido el fallo en una solicitud: en el proxy, en el destino o en la red. Por ejemplo, un error 403 suele indicar un bloqueo de IP, mientras que un 407 significa autenticación de proxy falló.
Optimización del web scraping
Los rastreadores utilizan códigos de estado para ajustar su comportamiento de forma dinámica. A 429: Demasiadas solicitudes activa la limitación automática del ancho de banda o la rotación de proxies, lo que contribuye a mantener el acceso a los sitios web de destino.
Buenas prácticas
Registrar y clasificar los códigos de estado
Registre siempre los códigos de estado durante raspado o operaciones de API. Reconocer patrones (como picos en los errores 403 o 429) ayuda a ajustar con precisión la configuración del proxy y los agentes de usuario.
Utilice la lógica de reintento y la rotación
Implemente los reintentos y Rotación de direcciones IP en caso de respuestas transitorias 5xx o 429. Esto mejora el tiempo de actividad y reduce el riesgo de bloqueos.
Seguir las tendencias de respuesta
Configure alertas para índices de error inusuales con el fin de detectar problemas de forma temprana, como credenciales de proxy caducadas o cambios en el sitio web de destino.
Conclusión
Los códigos de estado HTTP actúan como puente de comunicación entre el cliente y el servidor, indicando si una solicitud se ha realizado con éxito, ha fallado o requiere algún ajuste. Para los equipos que utilizan servidores proxy, comprender estos códigos les ayuda a identificar y resolver los problemas con mayor rapidez, mejorando así la fiabilidad de la conexión y la precisión de los datos.
Preguntas frecuentes
Describen cómo ha respondido un servidor a la solicitud de un cliente: si se ha realizado con éxito, si ha fallado o si requiere alguna acción adicional.
Le ayudan a determinar si un problema se debe a su proxy, al sitio web de destino o a la configuración del cliente.
Los errores 4xx indican problemas del lado del cliente (por ejemplo, una solicitud incorrecta o un acceso no autorizado), mientras que los errores 5xx indican fallos del lado del servidor.
En muchos casos, sí. La rotación de direcciones IP, el uso de proxies residenciales o una autenticación correcta suelen resolver los problemas relacionados con los códigos 4xx y 5xx.