GuíasWeb app

Tutorial: limitar las peticiones de una API (rate limiting)

Por el equipo de Banzai LabsActualizado el 2 min de lectura

5 / min200429Peticiones de un mismo clienteMás allá de la cuota: «demasiadas peticiones», reintentar luego
Más allá de la cuota, la API responde 429 en lugar de procesar la petición.

1. El código

import { createClient } from 'redis';
const redis = createClient({ url: process.env.REDIS_URL });
await redis.connect();

export async function limitar(clave: string, max = 60, ventana = 60) {
  const k = `rl:${clave}:${Math.floor(Date.now() / 1000 / ventana)}`;
  const n = await redis.incr(k);
  if (n === 1) await redis.expire(k, ventana);
  return { ok: n <= max, quedan: Math.max(0, max - n) };
}
const { ok } = await limitar(`ip:${ip}`, 5, 60);
if (!ok) return new Response('Demasiadas peticiones', { status: 429, headers: { 'Retry-After': '60' } });

2. Dónde poner un límite

Punto de entrada Regla de ejemplo
Inicio de sesión, enlace mágico 5 por minuto y por dirección
Formulario de contacto 3 por hora y por IP
Llamada a un modelo de IA Una cuota por usuario y por día
API pública Según el plan de cada cliente

3. Las respuestas correctas

  1. 1Código 429«Too Many Requests», el código previsto para esto.
  2. 2Retry-AfterEl plazo antes de reintentar, en segundos.
  3. 3Un mensaje claroEn la interfaz, no un error técnico.

Para el coste de la IA: limitar la factura de la API de IA.

Preguntas frecuentes

¿Por IP o por usuario?
Por usuario cuando ha iniciado sesión, por IP en otro caso. Detrás de un proxy o un CDN, lee la IP real en la cabecera que indique tu proveedor.
¿Ventana fija o deslizante?
La ventana fija es sencilla y a menudo basta. La ventana deslizante o el cubo de tokens suavizan los picos al borde del minuto.
¿Puede hacerlo el servidor web?
Sí, Nginx y la mayoría de los CDN tienen un límite integrado. El límite en el código sigue siendo útil para reglas por usuario o por función.

Para leer después

Todas las guías