Zum Inhalt springen

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

01

Die Richtlinie

Ein festes Fenster auf der öffentlichen Oberfläche, gezählt pro Zugriffsschlüssel.

public

Alle /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.

Von der API durchgesetzte Richtlinien
02

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.

HeaderBeispiel

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
03

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.

Beispiel: 429-Antwort