Ratenlimits & Guthaben
Was begrenzt ist
Ihr Tarif begrenzt vier Dinge, alle sichtbar unter GET /v1/account: überwachte Ziele, Stichwörter, gleichzeitige WebSocket-Verbindungen und Anfragen pro Minute. Die ersten beiden liefern 402 plan_limit mit details.resource, das dritte schließt den Socket mit 4002, das vierte liefert 429 rate_limited mit einem Retry-After-Header.
Header
Jede authentifizierte Antwort sagt Ihnen, wo Sie stehen, damit ein Client zurückweichen kann, bevor er abgewiesen wird:
| Header | Bedeutung |
|---|---|
X-RateLimit-Limit | Erlaubte Anfragen pro Minute für diesen Schlüssel |
X-RateLimit-Remaining | Was in der laufenden Minute noch übrig ist |
X-RateLimit-Reset | Unix-Zeit, zu der das Fenster zurückgesetzt wird |
X-Credits-Used-Today | Seit 00:00 UTC durch Lesezugriffe auf Abruf verbrauchtes Guthaben |
X-Request-Id | Nennen Sie sie uns, und wir finden die genaue Anfrage in unseren Logs |
X-Response-Time | Wie lange wir gebraucht haben, in Millisekunden |
ETag | Schwacher Validator einer JSON-Antwort; als If-None-Match zurücksenden |
Idempotent-Replay | true, wenn die Antwort die Wiederholung einer früheren Anfrage mit demselben Idempotency-Key ist |
Retry-After | Sekunden Wartezeit, bei jedem 429 |
Location | Wo die erstellte oder eingereihte Ressource liegt, bei 201 und 202 |
Guthaben
Streaming wird nicht gezählt – eine untätige und eine ausgelastete Verbindung kosten dasselbe, und die Frames auf dem Socket gehen nicht vom Anfragebudget ab. Die REST-Lesezugriffe auf Abruf unter Lesezugriffe verbrauchen Guthaben, ein oder zwei Einheiten pro Aufruf, wie beim jeweiligen Endpunkt angegeben; GET /v1/account/usage zeigt Ihre Tagessummen.