Todos nos hemos topado con un 404, y muchos con la temida pantalla del 500. Solemos leerlos como "algo salió mal, quién sabe qué". Pero esos números no son ruido: son un idioma preciso con el que los servidores web nos dicen exactamente qué pasó y, sobre todo, de quién es la culpa. Aprender a leerlos —aunque sea a grandes rasgos— convierte un error frustrante en un diagnóstico de segundos, y es una de esas alfabetizaciones básicas que separan a quien adivina de quien entiende.
El secreto está en el primer dígito
Cada respuesta web trae un código de estado HTTP de tres dígitos, y el primero lo agrupa en una familia. Con solo mirar ese primer número ya sabes de qué tipo de situación se trata:
- 2xx — Éxito. Todo salió bien. El 200 OK es el código que nunca ves, precisamente porque significa que funcionó y la página cargó sin drama.
- 3xx — Redirección. "Eso que pediste está en otro lado, te llevo." El 301 es un movimiento permanente (la página se mudó para siempre) y el 302, temporal. Ocurren en segundo plano; rara vez los notas.
- 4xx — Error del cliente (tú). El problema está en tu petición. Pediste algo que no existe, que no puedes ver, o mal formado.
- 5xx — Error del servidor (el otro lado). Tu petición estaba bien; el servidor falló al atenderla. La culpa no es tuya.
Esa distinción entre 4xx (culpa de la petición) y 5xx (culpa del servidor) es la más útil de todas. Ante un problema, saber en qué familia cae te dice de inmediato hacia dónde mirar: ¿corrijo lo que pedí, o el problema está del lado del servidor y no hay nada que yo pueda hacer salvo avisar?
Los que vale la pena reconocer
Del lado del cliente (4xx):
- 404 Not Found: el clásico. La página o recurso que pediste no existe (o la dirección está mal escrita, o el contenido se borró o movió).
- 403 Forbidden: el recurso existe, pero no tienes permiso para verlo. La puerta está ahí, pero cerrada para ti.
- 401 Unauthorized: necesitas identificarte (iniciar sesión) y no lo has hecho.
- 429 Too Many Requests: hiciste demasiadas peticiones muy rápido y el servidor te pide calma.
Del lado del servidor (5xx):
- 500 Internal Server Error: algo falló dentro del servidor y no supo ser más específico. El "se rompió algo aquí" genérico.
- 502 Bad Gateway / 504 Gateway Timeout: un servidor intermedio no obtuvo una respuesta buena (o a tiempo) del servidor de atrás. Típico de arquitecturas con varias capas.
- 503 Service Unavailable: el servidor está temporalmente no disponible, a menudo por sobrecarga o mantenimiento. Suele resolverse solo.
Por qué saber esto te sirve
Cuando un sitio falla, la reacción de la mayoría es "no funciona" a secas. Quien sabe leer el código actúa distinto: ve un 404 y revisa la dirección; ve un 403 y piensa en permisos; ve un 500 o 503 y sabe que el problema está en el servidor, no en su navegador —así que reiniciar su computadora no ayudará, y lo que toca es revisar el servidor o esperar—. Esa lectura rápida ahorra horas de buscar en el lugar equivocado. Y para quien administra un sitio en su hosting, los códigos son el primer mapa hacia la causa. Es el primo web de leer los códigos de error de correo: en ambos casos, el sistema te está diciendo qué pasó; solo hay que saber escucharlo.