Rate-Limits

RIXL-API-Anfragen können gedrosselt werden, wenn das Anfragevolumen die zulässigen Limits für Ihren Schlüssel oder Ihr Projekt überschreitet.

Wenn Sie gedrosselt werden

Wenn Ihre Anfragen gedrosselt werden, gibt die API zurück:

• 429 Too Many Requests

Empfohlenes Client-Verhalten

1. Erkennen Sie 429-Antworten.
2. Wiederholen Sie mit exponentiellem Backoff und Jitter.
3. Reduzieren Sie Anfrage-Bursts durch Bündelung und Caching, wo möglich.
4. Vermeiden Sie unbegrenzte Wiederholungsschleifen.

const baseDelayMs = 500;
const maxAttempts = 5;

async function requestWithBackoff(fetcher) {
  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
    const response = await fetcher();
    if (response.status !== 429) return response;

    const jitter = Math.floor(Math.random() * 200);
    const delay = baseDelayMs * (2 ** attempt) + jitter;
    await new Promise((resolve) => setTimeout(resolve, delay));
  }

  throw new Error("Rate limit retries exhausted");
}

Betriebshinweise

• Verwenden Sie separate API-Schlüssel pro Umgebung (dev, staging, prod), um den Datenverkehr zu isolieren.
• Bevorzugen Sie warteschlangenbasierte Verarbeitung für stoßweise Ingestion-Workloads.
• Überwachen Sie die 429-Häufigkeit und passen Sie die Nebenläufigkeit an, bevor Sie den Datenverkehr hochskalieren.

Verwandtes

• API-Referenz
• API-Schlüssel
• Fehlerbehandlung