Ratenbegrenzung
Der Durchsatz wird je Schlüssel über ein Zeitfenster von einer Minute gezählt. Die Obergrenze richtet sich nach dem Tarif des Kontos: 60 Anfragen pro Minute im kostenlosen Tarif, 600 im Tarif Pro.
Obergrenzen
| Tarif | Anfragen pro Minute |
|---|---|
| Kostenlos | 60 |
| Pro | 600 |
Header
Jede Antwort trägt X-RateLimit-Limit und X-RateLimit-Remaining. Eine 429-Antwort trägt zusätzlich Retry-After in Sekunden. Lesen Sie diese Header, statt Ihre Aufrufe selbst zu zählen: Die Obergrenze kann sich mit dem Tarif im laufenden Betrieb ändern.
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
Retry-After: 37
{ "error": { "code": "rate_limited",
"message": "Rate limit of 60 requests per minute exceeded." } }Je Schlüssel, nicht je Konto
Zwei Integrationen desselben Kontos nehmen sich damit nichts weg, und es ist erkennbar, welche das Kontingent verbraucht. Ebendeshalb hilft der Widerruf eines außer Kontrolle geratenen Schlüssels dem übrigen Konto sofort.
Bei einem 429
Warten Sie die in Retry-After genannten Sekunden ab und versuchen Sie es erneut. Das Fenster ist fest: Danach steht der Zähler wieder auf null.
Blättern Sie mit einem hohen limit, statt viele kleine Seiten abzurufen: Hundert Einträge kosten eine Anfrage, nicht hundert. Rufen Sie für eine Synchronisation /v1/commissions mit from auf dem Zeitpunkt Ihres letzten Laufs auf, statt alles erneut zu lesen.