Ratenbegrenzungen

Wie die Begrenzung funktioniert

Anfragen werden je Organisation über ein gleitendes Ein-Minuten-Fenster ratenbegrenzt. Ihr Kontingent pro Minute wird durch Ihren Tarif festgelegt; alle Schlüssel einer Organisation teilen sich dasselbe Fenster. Sandbox-Verkehr wird in einem separaten Topf gemessen, sodass das Erkunden der API nie Ihr Produktionskontingent aufbraucht.

Antwortheader

Jede Antwort meldet Ihren aktuellen Stand:

• X-RateLimit-Limit — die maximal im Fenster erlaubten Anfragen.
• X-RateLimit-Remaining — im aktuellen Fenster noch verfügbare Anfragen.
• Retry-After — nur bei einem 429 gesendet; die Anzahl der Sekunden, die vor einem erneuten Versuch zu warten ist.

429 Too Many Requests behandeln

Wenn Sie das Limit überschreiten, antwortet PIE mit 429, der Standard-Fehlerhülle und einem Retry-After-Header:

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

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

Warten Sie vor dem erneuten Versuch mindestens Retry-After Sekunden. Ein robuster Client berücksichtigt den Header und fügt Jitter hinzu, um einen synchronisierten Retry-Sturm zu vermeiden:

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);
  }
}