WebGroundwebground.app
Información y Guías · Referencia Web

Referencia de Códigos de Estado HTTP

Guía buscable de códigos HTTP 1xx–5xx con su significado y consejos prácticos para depurar APIs y CDNs.

Mostrando 26 códigos
100

Continue

El servidor recibió los encabezados iniciales; el cliente puede enviar el cuerpo.

Consejo: Habitual al enviar cargas grandes con la cabecera Expect: 100-continue.

101

Switching Protocols

El servidor aceptó actualizar el protocolo de conexión, normalmente de HTTP a WebSocket.

Consejo: Revisa las cabeceras Upgrade y Connection si falla el handshake WebSocket.

200

OK

Respuesta estándar que confirma que la petición HTTP tuvo éxito.

Consejo: Comprueba Content-Type y la estructura JSON si el cliente aún falla al renderizar.

201

Created

La petición tuvo éxito y creó uno o más recursos nuevos.

Consejo: Las APIs REST suelen devolver la cabecera Location apuntando al recurso creado.

204

No Content

La petición tuvo éxito y el servidor devolvió un cuerpo vacío intencionadamente.

Consejo: Evita llamar a response.json() en respuestas 204 (frecuentes en DELETE u OPTIONS).

206

Partial Content

El servidor entregó solo el rango de bytes solicitado del archivo.

Consejo: Usado en streaming de vídeo y descargas reanudables mediante cabeceras Range.

301

Moved Permanently

El recurso se trasladó permanentemente a otra URL; los buscadores transfieren el SEO.

Consejo: Los navegadores cachean mucho el 301 — prueba reglas nuevas en incógnito o curl -I.

302

Found (Redirección temporal)

El recurso se sirve temporalmente desde otra URL manteniendo indexada la original.

Consejo: Muy usado en flujos OAuth o mantenimientos temporales.

304

Not Modified

La copia en caché sigue siendo válida según las cabeceras ETag o Last-Modified.

Consejo: Ahorra ancho de banda en activos estáticos; revisa Cache-Control si persisten archivos obsoletos.

307

Temporary Redirect

Redirección temporal que conserva estrictamente el método HTTP y el cuerpo originales.

Consejo: Usa 307 en vez de 302 cuando un POST deba seguir siendo POST tras redirigir.

308

Permanent Redirect

Redirección permanente que conserva estrictamente el método HTTP y el cuerpo.

Consejo: Frecuente en redirecciones de barra final de Next.js y canonización HTTPS.

400

Bad Request

El servidor no pudo procesar la petición por sintaxis inválida o parámetros incorrectos.

Consejo: Valida el formato JSON, los parámetros obligatorios y la cabecera Content-Type.

401

Unauthorized

Falta autenticación o el token es inválido o ha expirado.

Consejo: Verifica la expiración del token Bearer, el prefijo de API key o las cookies de sesión.

403

Forbidden

El servidor conoce al cliente o aplica una política, pero niega el permiso de acceso.

Consejo: Revisa roles RBAC, reglas CORS/WAF o permisos de archivos/buckets.

404

Not Found

El servidor no encuentra la ruta o el recurso solicitado.

Consejo: Comprueba barras finales, ruta base, enrutamiento DNS o IDs eliminados.

405

Method Not Allowed

El endpoint existe pero no admite el verbo HTTP enviado (ej. GET en lugar de POST).

Consejo: Inspecciona la cabecera Allow para ver qué métodos acepta el servidor.

408

Request Timeout

El cliente tardó demasiado en terminar de enviar la petición y el servidor cerró la conexión.

Consejo: Revisa subidas lentas en red móvil o tiempos de keep-alive entre proxies.

409

Conflict

La petición entra en conflicto con el estado actual del recurso destino.

Consejo: Frecuente al registrar un correo duplicado o por desacuerdo de ETag en bloqueo optimista.

413

Content Too Large

El tamaño de la carga supera el límite del servidor o proxy inverso.

Consejo: Comprime imágenes localmente antes de subirlas o amplía el límite del proxy.

415

Unsupported Media Type

El servidor rechaza el formato declarado en la cabecera Content-Type.

Consejo: Asegúrate de que Content-Type: application/json o multipart/form-data coincida con el cuerpo.

422

Unprocessable Content

La sintaxis es válida (p. ej., JSON bien formado), pero los datos fallaron la validación.

Consejo: Revisa el detalle del error por correos inválidos, cantidades negativas o campos faltantes.

429

Too Many Requests

El cliente superó el límite de tasa (rate limit) de la API.

Consejo: Respeta la cabecera Retry-After y aplica reintentos exponenciales con jitter.

500

Internal Server Error

Ocurrió una excepción inesperada no controlada en el servidor origen.

Consejo: Revisa trazas de error del servidor, variables de entorno faltantes o fallos de base de datos.

502

Bad Gateway

El proxy, CDN o balanceador recibió una respuesta inválida del servidor upstream.

Consejo: Comprueba que el proceso upstream esté activo y escuchando en el puerto esperado.

503

Service Unavailable

El servidor está temporalmente sobrecargado o en mantenimiento programado.

Consejo: Busca cabeceras Retry-After, fallos de health-check o límites de arranque en frío.

504

Gateway Timeout

El proxy o CDN agotó el tiempo de espera aguardando respuesta del servidor upstream.

Consejo: Optimiza consultas lentas de base de datos o mueve procesos largos a colas asíncronas.

¿Depurando un error 400 Bad Request o una respuesta JSON de API ahora mismo?Abrir formateador JSON

Cómo interpretar las cinco clases de códigos HTTP

Toda respuesta HTTP comienza con un código de tres dígitos definido en el estándar RFC 9110. Agruparlos por su primer dígito permite a desarrolladores, equipos DevOps y especialistas SEO diagnosticar incidentes en segundos.

En resumen: 1xx indica negociación de protocolo, 2xx confirma éxito, 3xx señala caché o redirección, 4xx apunta a errores de la petición del cliente y 5xx indica fallos en el servidor origen o proxy.

Confusiones frecuentes en producción

Distinguir códigos cercanos evita errores difíciles de rastrear:

  • 401 Unauthorized vs. 403 Forbidden: 401 significa falta de credenciales o token caducado; 403 indica cliente autenticado (o bloqueado por política) pero sin permiso.
  • 301/302 vs. 307/308: las redirecciones heredadas 301/302 pueden transformar un POST en GET, mientras que 307 y 308 conservan método y cuerpo.
  • 502 Bad Gateway vs. 504 Gateway Timeout: 502 indica respuesta inválida del servidor upstream y 504 significa que tardó demasiado en responder.

Preguntas Frecuentes

¿Qué diferencia hay entre 401 y 403?+

401 Unauthorized indica credenciales ausentes, expiradas o inválidas. 403 Forbidden significa que el servidor reconoce la identidad o política y deniega el acceso.

¿Cómo deben manejar los clientes un 429 Too Many Requests?+

Leer el encabezado Retry-After cuando exista y reintentar con espera exponencial (exponential backoff) y jitter aleatorio.

¿Por qué 204 No Content rompe response.json() en JavaScript?+

Porque las respuestas 204 tienen cuerpo vacío por diseño; llamar a response.json() lanza un error de análisis. Comprueba response.status === 204 antes.

Explorar más en WebGround

Ver todo