Ratenlimits
Ratenlimits halten die Leistung für Tenants vorhersehbar. Sie werden pro API-Schlüssel über ein festes 60-Sekunden-Fenster angewendet.
Stufen
| Stufe | Anfragen / Minute |
|---|---|
standard (Standard) | 120 |
elevated | 600 |
Die Stufe Ihres Schlüssels und das aktuelle Budget werden von GET /v1/auth/context (rate_limit_tier) und GET /v1/usage (rate_limit.limit_per_minute und rate_limit.remaining_per_minute) gemeldet. Lesen Sie immer die Live-Werte, anstatt sie fest zu codieren.
Wenn Sie das Limit überschreiten
Anfragen über dem Limit geben 429 mit code: "RATE_LIMITED" zurück. Warten Sie ab und wiederholen Sie es, nachdem das Fenster zurückgesetzt wurde.
Innerhalb der Limits entwerfen
- Cachen Sie Referenzdaten und bevorzugen Sie inkrementelle Synchronisierungen gegenüber dem Pollen ganzer Tabellen.
- Verwenden Sie Webhooks für ereignisgesteuerte Aktualisierungen anstelle von Polling.
- Warten Sie bei
429ab und vermeiden Sie parallele Wiederholungsstürme nach vorübergehenden Fehlern. - Kombinieren Sie Filter (
search,status,module), um weniger abzurufen.