Códigos de Estado HTTP Explicados

Los códigos de estado HTTP explicados, del 200 al 503

Cada vez que tu navegador pide algo a un servidor web, el servidor responde con un número de tres dígitos antes de enviar de vuelta cualquier HTML, imagen o JSON. Ese número es el código de estado HTTP, y es la forma breve que tiene el servidor de decir qué ocurrió: la página está aquí, se movió, no tienes permitido el acceso o algo se rompió de su lado. La mayoría del tiempo nunca ves estos códigos porque todo funciona y la página simplemente carga. Pero en el momento en que un sitio se comporta mal, el código de estado es la primera pista que vale la pena leer.

Los números no son aleatorios. El primer dígito clasifica cada respuesta en una de cinco familias, así que incluso un código desconocido te dice a grandes rasgos qué salió mal con solo mirar su cifra inicial. Aprende las cinco familias y podrás leer casi cualquier respuesta de un vistazo.

Las cinco clases

1xx informativo. El servidor recibió tu solicitud y aún está trabajando en ella. Estos son poco comunes en la navegación cotidiana y normalmente se gestionan de forma silenciosa entre el navegador y el servidor. 100 Continue es el ejemplo clásico, que le indica a un cliente que puede enviar el resto de un cuerpo de solicitud grande.

2xx éxito. La solicitud funcionó. 200 OK es el que quieres ver durante todo el día, ya que significa que el recurso se encontró y está de camino de vuelta. 201 Created aparece después de que envías un formulario o una llamada a la API que crea algo nuevo, y 204 No Content significa que la acción tuvo éxito pero no hay nada que mostrar.

3xx redirección. Lo que pediste vive en otro lugar, y el navegador normalmente lo sigue de forma automática. Las redirecciones mantienen vivos los enlaces antiguos e importan muchísimo para el posicionamiento en buscadores.

4xx error del cliente. Algo en la solicitud estaba mal de tu lado: una URL incorrecta, una sesión sin iniciar o un recurso que no existe. El servidor está sano; simplemente no puede aceptar lo que enviaste.

5xx error del servidor. Tu solicitud estaba bien, pero el servidor tropezó al procesarla. Estos apuntan a la infraestructura del sitio, no a ti.

Los códigos concretos que la gente realmente busca

200 OK es un éxito sin más. La página o los datos cargaron como se esperaba.

301 Moved Permanently le indica a los navegadores y a los buscadores que una página tiene un nuevo hogar permanente. Esta es la redirección amigable con el SEO, porque transfiere las señales de posicionamiento de la URL antigua a la nueva. Úsala cuando cambies una URL de forma definitiva.

302 Found es una redirección temporal. La URL original sigue siendo la real, así que los buscadores la siguen indexando en lugar del destino. Recurre a 302 solo cuando el traslado sea genuinamente breve, como cuando diriges a los usuarios a una página de destino de temporada.

304 Not Modified es el héroe silencioso de la navegación rápida. Le indica al navegador que la copia que ya tiene en su caché sigue vigente, así que el servidor se ahorra reenviar el archivo. Menos datos, páginas más rápidas.

400 Bad Request significa que el servidor ni siquiera pudo entender la solicitud, a menudo por una sintaxis mal formada o un parámetro no válido.

401 Unauthorized se traduce más o menos como "no sé quién eres, por favor autentícate". Te faltan credenciales válidas.

403 Forbidden es distinto: el servidor sabe quién eres y aun así se niega. No tienes permiso, e iniciar sesión de nuevo no servirá de nada.

404 Not Found es el código más famoso de todos. El servidor está activo y te respondió, pero no hay nada en esa dirección. Suele venir de un enlace mal escrito o de una página que se eliminó o se movió sin una redirección.

429 Too Many Requests significa que te han limitado la tasa de peticiones. Enviaste demasiadas solicitudes en muy poco tiempo, y el servidor te pide que vayas más despacio. Las API usan esto constantemente.

500 Internal Server Error es la respuesta genérica de "algo se rompió". El servidor encontró una condición inesperada y se rindió, pero no dice qué pasó. Revisa los registros del servidor.

502 Bad Gateway aparece cuando un servidor, que actúa como puerta de enlace o proxy, recibe una respuesta no válida de un servidor superior detrás de él. A menudo es señal de que una aplicación de backend se cayó o es inaccesible.

503 Service Unavailable significa que el servidor está temporalmente sobrecargado o fuera de servicio por mantenimiento. A diferencia de 500, implica que el problema es de corto plazo y que el sitio debería volver pronto.

Qué significan los códigos de estado para el SEO y la depuración

Para el posicionamiento en buscadores, la distinción entre 301 y 302 es la que más confunde a la gente. Un traslado permanente siempre debería usar 301 para que la página nueva herede la autoridad de la antigua; un 302 en el lugar equivocado puede dejar a los buscadores indexando la URL original y dividiendo tus señales. Mientras tanto, grandes cantidades de errores 404 desperdician presupuesto de rastreo y frustran a los visitantes, así que vale la pena redirigir o arreglar los enlaces rotos en lugar de dejarlos pudrir.

Para la depuración, la familia te dice dónde mirar. Un 4xx apunta a la solicitud, así que revisa la URL, las cabeceras y las credenciales. Un 5xx apunta al servidor, así que revisa los registros de la aplicación, los servicios superiores y si un despliegue acaba de salir mal. Una oleada de errores 502 y 503 a menudo significa que un backend está caído o sobrecargado más que un error de código. Puedes inspeccionar el estado exacto que devuelve un sitio con nuestras herramientas para desarrolladores, y cuando un 5xx parece más un problema de conectividad que una falla de la aplicación, una rápida consulta DNS puede confirmar que el dominio sigue resolviéndose a la dirección correcta.

Preguntas frecuentes