AthausDoku

REST-API: Limits und Drossel

Wie viele Aufrufe /v1 je Schlüssel und je Büro annimmt, welche Köpfe den Stand zeigen und was bei einem 429 zu tun ist.

Zuletzt aktualisiert:

/v1 drosselt nach dem Eimer-Prinzip: ein Vorrat an Aufrufen auf einmal, der mit fester Rate nachläuft. Gezählt wird je Schlüssel, und zusätzlich gilt ein Deckel für das ganze Büro.

EimerRateAuf einmal
Lesen, je Schlüssel10 je Sekunde100
Lesen, je Büro, über alle Schlüssel40 je Sekunde400
Schreiben, je Schlüssel2 je Sekunde60
Schreiben, je Büro, über alle Schlüssel8 je Sekunde240

Der Deckel des Büros ist das Vierfache des Schlüssels. So teilen sich mehrere Schlüssel eines Büros die Grenze nicht, laufen aber auch nicht ohne Obergrenze.

Die Köpfe

Jede Antwort zeigt den Stand des Eimers, der gerade gilt:

RateLimit-Policy: "read";q=100;w=10
RateLimit: "read";r=57;t=5
TeilBedeutung
"read"der Name des Eimers. Es gibt read und read-office
qder Vorrat auf einmal
wSekunden, bis ein leerer Eimer wieder voll ist
rso viele Aufrufe sind noch frei
tSekunden, bis der Eimer wieder voll ist

Die Syntax folgt dem Entwurf draft-ietf-httpapi-ratelimit-headers. Er ist noch ein Entwurf und kann sich ändern.

Wenn es zu viele werden

Die Antwort ist 429 mit rate_limited und dem Kopf Retry-After in Sekunden. Das Mitglied detail nennt die Ursache: den Schlüssel, das Büro oder zu viele Fehlversuche von einer Adresse.

HTTP/1.1 429 Too Many Requests
Retry-After: 3

Warte so lange und sende dieselbe Anfrage noch einmal. Eine gedrosselte Anfrage wird nie ausgeführt, du kannst sie also gefahrlos wiederholen.

Bei Listen spart limit=100 Aufrufe gegenüber vielen kleinen Seiten (Blättern).

Weiter lesen

Auf dieser Seite