GuidesWeb app

Tuto : limiter le débit d’une API (rate limiting)

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

5 / min200429Requêtes d’un même clientAu-delà du quota : « trop de requêtes », réessayer plus tard
Au-delà du quota, l’API répond 429 au lieu de traiter la requête.

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

  1. 1Code 429« Too Many Requests », le code prévu pour ça.
  2. 2Retry-AfterLe délai avant de réessayer, en secondes.
  3. 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.

À lire ensuite

Tous les guides