GuidesWeb app
Tuto : limiter le débit d’une API (rate limiting)
1. Le code
import { createClient } from 'redis';
const redis = createClient({ url: process.env.REDIS_URL });
await redis.connect();
export async function limiter(cle: string, max = 60, fenetre = 60) {
const k = `rl:${cle}:${Math.floor(Date.now() / 1000 / fenetre)}`;
const n = await redis.incr(k);
if (n === 1) await redis.expire(k, fenetre);
return { ok: n <= max, reste: Math.max(0, max - n) };
}
const { ok } = await limiter(`ip:${ip}`, 5, 60);
if (!ok) return new Response('Trop de requêtes', { status: 429, headers: { 'Retry-After': '60' } });
2. Où poser une limite
| Point d’entrée | Exemple de règle |
|---|---|
| Connexion, lien magique | 5 par minute et par adresse |
| Formulaire de contact | 3 par heure et par IP |
| Appel à un modèle IA | Un quota par utilisateur et par jour |
| API publique | Selon l’offre de chaque client |
3. Les bonnes réponses
- 1Code 429« Too Many Requests », le code prévu pour ça.
- 2Retry-AfterLe délai avant de réessayer, en secondes.
- 3Un message clairCôté interface, pas une erreur technique.
Pour le coût des IA : plafonner sa facture d’API.
Questions fréquentes
- Par IP ou par utilisateur ?
- Par utilisateur quand il est connecté, par IP sinon. Derrière un proxy ou un CDN, lisez l’IP réelle dans l’en-tête prévu par votre hébergeur.
- Fenêtre fixe ou glissante ?
- La fenêtre fixe est simple et suffit souvent. La fenêtre glissante ou le seau à jetons lissent les pics en bordure de minute.
- Le serveur web peut-il le faire ?
- Oui, Nginx et la plupart des CDN ont une limite intégrée. La limite dans le code reste utile pour des règles par utilisateur ou par fonction.