Comprendiendo los códigos de estado HTTP: Guía completa

Cada vez que tu navegador se comunica con un servidor web, el servidor devuelve un código de estado HTTP. Estos números de tres dígitos le dicen a tu navegador si la solicitud fue exitosa, fue redirigida o encontró un error. Comprender estos códigos de estado es crucial para desarrolladores web, profesionales de SEO y cualquier persona que gestione un sitio web.

Cómo se organizan los códigos de estado HTTP

Los códigos de estado HTTP se agrupan en cinco categorías según el primer dígito. Cada categoría representa una clase de respuesta que te ayuda a identificar rápidamente la naturaleza de la respuesta del servidor.

Categoría	Clasificación	Significado
1xx	Informativo	Solicitud recibida, continuando procesamiento
2xx	Éxito	Solicitud recibida y procesada exitosamente
3xx	Redirección	Se necesita acción adicional para completar la solicitud
4xx	Error del cliente	La solicitud contiene sintaxis incorrecta o no puede ser satisfecha
5xx	Error del servidor	El servidor no pudo completar una solicitud válida

1xx Respuestas informativas

Estos códigos de estado indican que el servidor ha recibido la solicitud y está continuando con el procesamiento. Raramente se ven en la navegación diaria pero son importantes para la negociación de protocolos.

100 Continue: El servidor ha recibido las cabeceras de la solicitud y el cliente debe continuar enviando el cuerpo de la solicitud.
101 Switching Protocols: El servidor está cambiando de protocolo según lo solicitado por el cliente a través de la cabecera Upgrade.
103 Early Hints: Se usa para precargar recursos antes de que la respuesta final esté lista, mejorando el rendimiento de carga de la página.

2xx Respuestas exitosas

Estos códigos de estado confirman que la solicitud fue recibida, comprendida y procesada exitosamente.

200 OK: La respuesta de éxito estándar. El recurso solicitado fue encontrado y devuelto.
201 Created: Un nuevo recurso fue creado exitosamente, típicamente en respuesta a una solicitud POST.
204 No Content: La solicitud tuvo éxito pero no hay contenido que devolver. Común en solicitudes DELETE.
206 Partial Content: El servidor entrega solo una parte del recurso, usado para descargas de archivos grandes y streaming de video.

3xx Respuestas de redirección

Los códigos de estado de redirección indican al cliente que el recurso solicitado está disponible en una ubicación diferente. Son cruciales para el SEO porque afectan cómo los motores de búsqueda indexan tus páginas.

301 Moved Permanently: El recurso se ha movido permanentemente a una nueva URL. Los motores de búsqueda transfieren la autoridad de enlaces a la nueva URL. Esta es la redirección más importante para el SEO.
302 Found: El recurso se encuentra temporalmente en una URL diferente. Los motores de búsqueda generalmente conservan la indexación de la URL original. Úsalo solo para migraciones temporales.
304 Not Modified: Indica que la versión en caché del recurso sigue siendo válida. Esto ahorra ancho de banda evitando transferencias de datos innecesarias.
307 Temporary Redirect: Similar a 302 pero garantiza que el método HTTP no cambiará. Más confiable que 302 para implementaciones técnicas.
308 Permanent Redirect: Similar a 301 pero garantiza que el método HTTP no cambiará. Una alternativa moderna a 301 para redirecciones permanentes.

Solicitud exitosa (GET, HEAD)

4xx Errores del cliente

Estos códigos de estado indican que el cliente cometió un error en la solicitud. Son los errores más comúnmente encontrados por los visitantes del sitio web.

400 Bad Request: El servidor no puede procesar la solicitud debido a un error de formato de sintaxis. Verifica los parámetros de tu solicitud y las cabeceras.
401 Unauthorized: Se requiere autenticación y no se proporcionó o falló la verificación. El usuario necesita iniciar sesión.
403 Forbidden: El servidor entiende la solicitud pero se niega a autorizarla. A diferencia de 401, la autenticación no ayudaría.
404 Not Found: El recurso solicitado no existe en el servidor. Es el código de error más común y puede tener un impacto significativo en el SEO si no se maneja correctamente.
405 Method Not Allowed: El método de solicitud (GET, POST, PUT, etc.) no está soportado por el recurso solicitado.
429 Too Many Requests: El usuario ha enviado demasiadas solicitudes en un período de tiempo determinado. Es limitación de velocidad, común en APIs.

5xx Errores del servidor

Estos códigos de estado indican que el servidor no pudo completar una solicitud válida. Representan problemas del lado del servidor que requieren atención inmediata.

500 Internal Server Error: Mensaje de error genérico cuando el servidor encuentra una condición inesperada. Revisa los registros del servidor para encontrar la causa raíz.
502 Bad Gateway: El servidor, actuando como puerta de enlace, recibió una respuesta inválida de un servidor ascendente. Común en proxies inversos y CDN.
503 Service Unavailable: El servidor no puede manejar temporalmente la solicitud, generalmente debido a mantenimiento o sobrecarga. Usa el encabezado Retry-After para indicar cuándo reintentar.
504 Gateway Timeout: El servidor, actuando como puerta de enlace, no recibió una respuesta oportuna del servidor ascendente.

Cómo depurar códigos de estado HTTP

Al solucionar errores HTTP, sigue este enfoque sistemático:

Verifica el código de estado: Determina si es un error del cliente (4xx) o del servidor (5xx).
Revisa los registros del servidor: Para errores 5xx, los registros del servidor contienen seguimientos de pila y detalles del error.
Inspecciona las cabeceras de la solicitud: Usa las herramientas de desarrollador del navegador para verificar que la solicitud contenga las cabeceras, cookies y tokens de autenticación correctos.
Prueba con curl: Reproduce la solicitud usando curl para aislar si el problema está en el lado del cliente o del servidor.
Verifica los cambios recientes: Despliegues, actualizaciones de configuración o cambios de DNS a menudo causan errores de código de estado.

¿Quieres buscar rápidamente cualquier código de estado HTTP? Prueba nuestra herramienta gratuita de referencia de códigos de estado HTTP.

Preguntas frecuentes

¿Cuáles son los códigos de estado HTTP más comunes?

El código de estado HTTP más común es 200 OK, que indica una solicitud exitosa. Otros códigos comúnmente encontrados incluyen 301 Moved Permanently, 404 Not Found y 500 Internal Server Error.

¿Cuál es la diferencia entre redirección 301 y 302?

Una redirección 301 es permanente, indicando a los motores de búsqueda que transfieran la autoridad de enlaces a la nueva URL. Una redirección 302 es temporal, indicando a los motores de búsqueda que mantengan la URL original indexada. Usa 301 para movimientos permanentes y 302 para cambios temporales.

¿Cómo solucionar el error 403 Forbidden?

Un error 403 significa que el servidor entiende la solicitud pero rechaza la autorización. Verifica los permisos de archivos, valida las credenciales de autenticación, asegura que el usuario tenga acceso y verifica restricciones de IP o complementos de seguridad que bloqueen.

¿Qué significa el código de estado 429?

El código de estado 429 Too Many Requests significa que has enviado demasiadas solicitudes en un período de tiempo determinado. Esto es limitación de tasa. La respuesta típicamente incluye un encabezado Retry-After que indica cuánto tiempo esperar antes de volver a solicitar.

¿Un error 500 es mi problema o del servidor?

500 Internal Server Error es un problema del lado del servidor no causado por la solicitud del cliente. Típicamente indica un error en el código del servidor, una mala configuración o problemas de agotamiento de recursos. Sin embargo, si tu solicitud desencadenó el error del servidor, modificar la solicitud puede evitarlo.