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.
| Eimer | Rate | Auf einmal |
|---|---|---|
| Lesen, je Schlüssel | 10 je Sekunde | 100 |
| Lesen, je Büro, über alle Schlüssel | 40 je Sekunde | 400 |
| Schreiben, je Schlüssel | 2 je Sekunde | 60 |
| Schreiben, je Büro, über alle Schlüssel | 8 je Sekunde | 240 |
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| Teil | Bedeutung |
|---|---|
"read" | der Name des Eimers. Es gibt read und read-office |
q | der Vorrat auf einmal |
w | Sekunden, bis ein leerer Eimer wieder voll ist |
r | so viele Aufrufe sind noch frei |
t | Sekunden, 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: 3Warte 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
REST-API: der erste Aufruf
Die REST-API liest und schreibt Inserate, Kontakte, Anfragen, Besichtigungen und Dateien deines Büros. Ein Key, ein Aufruf, JSON zurück.
REST-API: Fehler als Problem Details
Jeder Fehler von /v1 ist ein Problem nach RFC 9457 mit echtem HTTP-Status, einem Code zum Verzweigen und einer Request-Id für den Support.
MCP-Grenzen: Drossel und Größen
Wie viel die zwei MCP-Server auf einmal annehmen, wie groß ein Aufruf, eine Liste, ein Text oder eine Datei sein darf, und was kein Werkzeug ohne Klick tut.