Qué significan los códigos de estado HTTP

Cada vez que tu navegador habla con un servidor, recibe un número de tres dígitos que funciona como semáforo digital. Los códigos de estado HTTP te dicen exactamente qué pasó con tu petición y qué debe hacer tu aplicación a continuación. Si trabajas con desarrollo web, entenderlos es la diferencia entre una app que falla en silencio y una que responde con claridad.

¿Qué son los códigos de estado HTTP y por qué importan?

Cuando envías una petición HTTP, necesitas saber qué ocurrió del otro lado. ¿Se procesó bien? ¿Hubo un problema? ¿El servidor pide algo distinto? Los códigos de estado son la forma estandarizada en que los servidores comunican ese resultado.

Piénsalo así: son como señales de tránsito en una autopista. Cada número tiene un significado específico y le indica a tu aplicación cuál es el siguiente paso. Sin ellos, tu navegador estaría conduciendo a ciegas.

¿Qué es un código de estado HTTP? Es un número de tres dígitos que el servidor envía junto con su respuesta para indicarle al cliente si la petición fue exitosa, redirigida o falló, y por qué.

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

Los códigos se agrupan en cinco familias, cada una identificada por su primer dígito. Esa lógica te permite saber, casi de un vistazo, qué tipo de respuesta estás recibiendo.

Familias 1xx, 2xx y 3xx: información, éxito y redirección

Las primeras tres familias cubren los escenarios donde la comunicación fluye sin errores graves.

• 1xx Información en proceso: significan "recibí tu mensaje, dame un momento". Son como cuando llamas a alguien y te dice espera, ya te atiendo. En aplicaciones web modernas rara vez los ves directamente porque el navegador los maneja por ti.
• 2xx Todo salió bien: son los códigos de éxito. Cuando ves un número que empieza por dos, tu petición se procesó correctamente.
• 3xx Te voy a redirigir: indican que el recurso está en otro lugar. Es como llegar a una dirección y encontrar un letrero que dice nos mudamos a.

Familias 4xx y 5xx: cuando algo sale mal

Aquí es donde un buen manejo de errores se vuelve crítico para la experiencia de usuario.

• 4xx Error del cliente: aquí las cosas se ponen interesantes. Estos códigos indican que algo está mal con la petición que enviaste, ya sea una URL incorrecta, falta de autenticación o datos mal formados.
• 5xx Error del servidor: cuando el servidor tiene problemas internos, responde con estos códigos. No es culpa de tu petición, sino que algo falló del otro lado.

¿Cuál es la diferencia entre un error 4xx y un 5xx? Un 4xx significa que el problema viene del cliente (tu petición tiene algo mal). Un 5xx significa que el servidor falló al procesar una petición que era válida.

¿Cómo deberías manejar los códigos de estado en tu aplicación?

Los códigos no son solo números decorativos en la pestaña Network de DevTools. Son instrucciones específicas sobre qué hacer después. Una aplicación robusta los maneja apropiadamente: muestra mensajes claros al usuario, reintenta peticiones cuando tiene sentido y toma acciones correctas de forma automática cuando es posible.

La próxima vez que abras DevTools y veas esos tres dígitos en la columna de estado, ya sabes qué está pasando bajo el capó y cómo debería reaccionar tu código.

¿Dónde puedo ver los códigos de estado HTTP de mi aplicación? En la pestaña Network de DevTools del navegador. Cada petición muestra su código en la columna de estado, junto con detalles del request y la respuesta.

En la sección de recursos encontrarás la especificación oficial del protocolo HTTP con el significado de cada status code. Cuéntame en los comentarios cuáles ya conocías y cuáles son nuevos para ti.