Ratenbegrenzungen

Ratenbegrenzungen, Kontingente und Umgang mit 429-Antworten.

Ratenbegrenzungen

AllToken setzt Ratenbegrenzungen ein, um eine faire Nutzung für alle zu gewährleisten. Die Limits gelten pro API-Schlüssel und variieren je nach Kontotyp.

Bei Überschreitung der Ratenbegrenzung gibt die API 429 Too Many Requests zurück. Implementieren Sie in Ihrer Retry-Logik einen exponentiellen Backoff:

TypeScript
1async function withRetry(fn, maxRetries = 3) {
2 for (let i = 0; i < maxRetries; i++) {
3 try {
4 return await fn();
5 } catch (err) {
6 if (err.status === 429 && i < maxRetries - 1) {
7 await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
8 continue;
9 }
10 throw err;
11 }
12 }
13}

Ratenbegrenzungs-Header

Informationen zur Ratenbegrenzung sind in den Antwort-Headern enthalten:

  • x-ratelimit-limit — Maximale Anfragen pro Zeitfenster
  • x-ratelimit-remaining — Verbleibende Anfragen im aktuellen Fenster
  • x-ratelimit-reset — Zeitstempel für den Reset des Fensters