ecentic API: Rate-Limits.
Jede öffentliche Antwort enthält den Live-Status Ihres Rate-Limit-Fensters, damit ein Agent sein Tempo anpassen kann, statt das Limit erst durch eine Ablehnung zu entdecken.
Live-Header · Retry-After bei 429 · Fenster pro Schlüssel
Die Richtlinie
Ein festes Fenster auf der öffentlichen Oberfläche, gezählt pro Zugriffsschlüssel.
publicAlle /api/v1-Endpunkte
120Anfragen
pro 60 Sekunden
news/api/v1/news
30Anfragen
pro 60 Sekunden
news-resolve/api/v1/news?resolve=true
6Anfragen
pro 60 Sekunden
Anfragen mit Bearer-Schlüssel werden gegen diesen Schlüssel gezählt; alles andere wird gegen die Client-IP gezählt, damit ein einzelner überaktiver Agent nicht das Budget einer gemeinsam genutzten Adresse verbraucht.
Das Fenster ist fest und nicht gleitend: Es wird an einer festen Uhrzeit zurückgesetzt, und der reset-Wert in den Headern ist die Anzahl der Sekunden bis zu diesem Zeitpunkt.
Header
Beide Schreibweisen werden gesendet. Verwenden Sie diejenige, die Ihr Client bereits versteht.
RateLimit-Policy ist immer vorhanden, weil die Richtlinie unabhängig davon gilt, ob eine bestimmte Anfrage gezählt werden konnte. Die Live-Zähler werden nur gesendet, wenn tatsächlich ein Zählerwert dahintersteht – eine Umgebung, die den Zähler nicht erreichen kann, lässt sie weg, statt ein Budget zu behaupten, das niemand gemessen hat.
Wählen Sie einen Header aus, um seine Bedeutung zu lesen. Diese Werte veranschaulichen eine Antwort; sie sind kein Live-Zähler.
Bedeutung: Die aktive Richtlinie: Kontingent und Fensterlänge in Sekunden.
Eine Grenze, zwei Darstellungen
In diesem Beispiel beschreiben beide Header-Formate dasselbe Zeitfenster.
- Verbleibende Anfragen
- 118
- r=118 · RateLimit-Remaining
- Sekunden bis zum Reset
- 42
- t=42 · RateLimit-Reset
Wenn Sie das Limit überschreiten
Ein 429 ist wie jeder andere Fehler ein typisiertes Problemdokument.
Die Antwort ist application/problem+json mit dem Code rate-limited und enthält Retry-After zusammen mit den Rate-Limit-Headern. Warten Sie die angegebene Anzahl an Sekunden ab, statt sofort erneut zu versuchen – ein erneuter Versuch innerhalb desselben Fensters wird gezählt und erneut abgelehnt.