Saltar al contenido

Códigos de Estado HTTP: Más Allá del 404, Todo lo que Necesitas Saber

Domina los códigos de estado HTTP con esta guía completa. Desde respuestas exitosas hasta errores del servidor, entiende cómo funciona la comunicación web.

Alberto Guaman diciembre 7, 2024 10 min de lectura

Compartir
Códigos de Estado HTTP: Más Allá del 404, Todo lo que Necesitas Saber
En este artículo
  1. ¿Qué son los códigos de estado HTTP?
  2. ¿Por qué son importantes?
  3. Clasificación de los códigos de estado HTTP
  4. Los códigos más usados y su significado
  5. Ejemplo práctico: Manejo de códigos HTTP en una API con Node.js
  6. Buenas prácticas
  7. Tabla resumen de códigos comunes
  8. Recursos útiles

¿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

RangoSignificado
1xxInformativos
2xxÉxito
3xxRedirección
4xxError del cliente
5xxError 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ódigoSignificadoCuándo usarlo
200OKRespuesta exitosa
201CreatedRecurso creado (POST)
204No ContentSin contenido que devolver
301Moved PermanentlyRedirección permanente
302FoundRedirección temporal
304Not ModifiedCaché, sin cambios
400Bad RequestSolicitud mal formada
401UnauthorizedRequiere autenticación
403ForbiddenAcceso denegado
404Not FoundRecurso no encontrado
429Too Many RequestsLímite de solicitudes superado
500Internal Server ErrorError interno del servidor
502Bad GatewayPuerta de enlace inválida
503Service UnavailableServicio no disponible
504Gateway TimeoutTiempo de espera agotado

Recursos útiles


¿Listo para dominar los códigos HTTP?
¡Conocerlos te hará mejor desarrollador y mejorará la experiencia de tus usuarios!

Escribimos sobre lo que construimos.

En Tinguar desarrollamos webs, apps, sistemas e integraciones para negocios. Si un artículo se parece a lo que necesitas, podemos construirlo contigo.

Escríbenos tu caso

Puede ser un producto que ya tenemos o algo que todavía no existe. No hace falta que sepas qué tecnología usar: con tu descripción te proponemos el siguiente paso.

¿Qué necesitas?

Se abre WhatsApp o tu correo con el mensaje listo. Tú decides cuándo enviarlo.

Cotizar proyecto WhatsApp