Limites de débit

Comment fonctionne la limitation

Les requêtes sont limitées en débit par organisation, sur une fenêtre glissante d'une minute. Votre allocation par minute est fixée par votre forfait ; toutes les clés d'une organisation partagent la même fenêtre. Le trafic bac à sable est mesuré dans un compartiment séparé, de sorte qu'explorer l'API n'entame jamais votre quota de production.

En-têtes de réponse

Chaque réponse indique votre situation actuelle :

• X-RateLimit-Limit — le maximum de requêtes autorisées dans la fenêtre.
• X-RateLimit-Remaining — les requêtes encore disponibles dans la fenêtre courante.
• Retry-After — envoyé uniquement sur un 429 ; le nombre de secondes à attendre avant de réessayer.

Gérer 429 Too Many Requests

Lorsque vous dépassez la limite, PIE répond 429 avec l'enveloppe d'erreur standard et un en-tête Retry-After :

HTTP/1.1 429 Too Many Requests
Retry-After: 12

{ "error": { "code": "RATE_LIMITED", "message": "Too many requests" } }

Patientez au moins Retry-After secondes avant de réessayer. Un client robuste respecte l'en-tête et ajoute du jitter pour éviter une tempête de tentatives synchronisées :

async function call(url, key) {
  for (let attempt = 0; ; attempt++) {
    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);
    await sleep((wait + Math.random()) * 1000);
  }
}