Qué significan los códigos de estado HTTP

Cada vez que tu navegador carga una página o una app llama a una API, el servidor responde con un código de estado de tres dígitos. La mayor parte del tiempo no lo ves, pero cuando algo se rompe — un 404, un 500 — ese número es la primera pista. Esta guía te enseña a leer los códigos de estado de un vistazo.

Lee el primer dígito

El truco es que el primer dígito te dice la categoría, así puedes entender la intención de un código que nunca has visto:

• 1xx — Informational: recibido, aún procesando (raro en el uso diario).
• 2xx — Success: funcionó.
• 3xx — Redirection: el recurso está en otra parte.
• 4xx — Client error: la petición estaba mal (tu lado).
• 5xx — Server error: la petición estaba bien, el servidor falló.

Esa división 4xx contra 5xx es la distinción más útil al depurar: 4xx significa arregla la petición; 5xx significa que la culpa es del servidor.

Los códigos que realmente te encontrarás

Éxito y redirecciones

• 200 OK — la respuesta estándar de «funcionó».
• 201 Created — se creó un nuevo recurso (tras un POST).
• 301 Moved Permanently — esta URL se ha movido de forma permanente; actualiza tus enlaces. Importante para el SEO.
• 302 Found — una redirección temporal; sigue usando la URL original.
• 304 Not Modified — tu copia en caché sigue siendo válida, así que no se reenvió nada.

Errores del cliente (4xx)

• 400 Bad Request — la petición estaba mal formada.
• 401 Unauthorized — necesitas autenticarte (iniciar sesión).
• 403 Forbidden — estás autenticado pero no tienes permiso.
• 404 Not Found — el recurso no existe.
• 429 Too Many Requests — te están limitando la tasa; ve más despacio.

Errores del servidor (5xx)

• 500 Internal Server Error — un fallo genérico del lado del servidor.
• 502 Bad Gateway — un servidor upstream devolvió una respuesta incorrecta.
• 503 Service Unavailable — el servidor está sobrecargado o caído por mantenimiento.
• 504 Gateway Timeout — un servidor upstream no respondió a tiempo.

401 vs. 403: una confusión común

Estos dos se sienten parecidos pero difieren en una palabra. 401 Unauthorized en realidad significa «no autenticado» — el servidor no sabe quién eres, así que inicia sesión. 403 Forbidden significa que el servidor sabe quién eres y aun así no tienes permiso. Uno va de identidad, el otro de permiso.

La lista completa

Para cada código registrado con su significado — con búsqueda y agrupado por clase — mira nuestra referencia completa de códigos de estado HTTP. Si estás depurando respuestas de API, nuestras guías sobre JWT y codificación de URL cubren otras dos cosas con las que te toparás constantemente.