Limites de débit

Les limites s’appliquent par clé API et par minute, selon votre offre.

En-têtes

Chaque réponse indique votre fenêtre en cours :

• x-ratelimit-limit requêtes autorisées par minute
• x-ratelimit-remaining requêtes restantes dans cette fenêtre
• x-ratelimit-reset secondes avant la réinitialisation de la fenêtre

En cas de dépassement

Vous recevez 429 rate_limited avec un en-tête retry-after. Les requêtes limitées ne sont pas facturées. Attendez le nombre de secondes indiqué, idéalement avec une part d’aléa :

async function call(url, key, tries = 4) {
  for (let i = 0; i < tries; i++) {
    const res = await fetch(url, { headers: { "x-api-key": key } });
    if (res.status !== 429) return res;
    const wait = Number(res.headers.get("retry-after") ?? 1) * 1000;
    await new Promise((r) => setTimeout(r, wait + Math.random() * 250));
  }
  throw new Error("Rate limited");
}

Besoin de limites plus élevées ? Contactez-nous.