GuíasWeb app
Tutorial: limitar las peticiones de una API (rate limiting)
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
- 1Código 429«Too Many Requests», el código previsto para esto.
- 2Retry-AfterEl plazo antes de reintentar, en segundos.
- 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.