¿Sabías que el famoso 404 es solo uno de muchos códigos de estado HTTP?
Entenderlos es esencial para cualquier desarrollador web.
¿Qué son los códigos de estado HTTP?
Los códigos de estado HTTP son respuestas numéricas que un servidor envía al navegador o cliente para indicar el resultado de una solicitud. Ayudan a diagnosticar problemas, mejorar la experiencia de usuario y optimizar el SEO.
¿Por qué son importantes?
- Comunicación clara: Informan al cliente si la solicitud fue exitosa, redirigida, fallida o requiere autenticación.
- Depuración: Facilitan el diagnóstico de errores.
- SEO: Google y otros motores de búsqueda los usan para indexar correctamente tu sitio.
- Experiencia de usuario: Permiten mostrar mensajes personalizados y páginas de error amigables.
Clasificación de los códigos de estado HTTP
| Rango | Significado |
|---|---|
| 1xx | Informativos |
| 2xx | Éxito |
| 3xx | Redirección |
| 4xx | Error del cliente |
| 5xx | Error del servidor |
Los códigos más usados y su significado
1xx: Informativos
- 100 Continue: El servidor recibió la solicitud inicial, el cliente puede continuar.
2xx: Éxito
- 200 OK: Todo salió bien, respuesta estándar para éxito.
- 201 Created: Recurso creado exitosamente (POST).
- 204 No Content: Solicitud exitosa, pero sin contenido para devolver.
3xx: Redirección
- 301 Moved Permanently: El recurso se movió de forma permanente (SEO: redirección ideal).
- 302 Found: Redirección temporal.
- 304 Not Modified: El recurso no ha cambiado, usa la versión en caché.
4xx: Error del cliente
- 400 Bad Request: Solicitud mal formada.
- 401 Unauthorized: Requiere autenticación.
- 403 Forbidden: Acceso denegado.
- 404 Not Found: Recurso no encontrado (el más famoso).
- 429 Too Many Requests: Demasiadas solicitudes en poco tiempo (rate limit).
5xx: Error del servidor
- 500 Internal Server Error: Error genérico del servidor.
- 502 Bad Gateway: El servidor recibió una respuesta inválida de otro servidor.
- 503 Service Unavailable: El servidor no está disponible (sobrecarga o mantenimiento).
- 504 Gateway Timeout: El servidor no recibió respuesta a tiempo.
Ejemplo práctico: Manejo de códigos HTTP en una API con Node.js
app.get('/usuario/:id', (req, res) => {
const usuario = db.findUser(req.params.id);
if (!usuario) {
return res.status(404).json({ error: 'Usuario no encontrado' });
}
res.status(200).json(usuario);
});Buenas prácticas
- Usa el código correcto para cada situación (no devuelvas siempre 200).
- Personaliza las páginas de error (404, 500) para mejorar la experiencia de usuario.
- Usa 301 para redirecciones permanentes y 302 para temporales.
- No reveles información sensible en los mensajes de error.
Tabla resumen de códigos comunes
| Código | Significado | Cuándo usarlo |
|---|---|---|
| 200 | OK | Respuesta exitosa |
| 201 | Created | Recurso creado (POST) |
| 204 | No Content | Sin contenido que devolver |
| 301 | Moved Permanently | Redirección permanente |
| 302 | Found | Redirección temporal |
| 304 | Not Modified | Caché, sin cambios |
| 400 | Bad Request | Solicitud mal formada |
| 401 | Unauthorized | Requiere autenticación |
| 403 | Forbidden | Acceso denegado |
| 404 | Not Found | Recurso no encontrado |
| 429 | Too Many Requests | Límite de solicitudes superado |
| 500 | Internal Server Error | Error interno del servidor |
| 502 | Bad Gateway | Puerta de enlace inválida |
| 503 | Service Unavailable | Servicio no disponible |
| 504 | Gateway Timeout | Tiempo de espera agotado |
Recursos útiles
- Lista completa de códigos HTTP (MDN)
- RFC 7231 - HTTP/1.1 Semantics and Content
- Guía de errores HTTP para desarrolladores
¿Listo para dominar los códigos HTTP?
¡Conocerlos te hará mejor desarrollador y mejorará la experiencia de tus usuarios!
Explorar etiquetas