Ratenbegrenzung

Verstehen Sie die Ratenbegrenzungen und wie Sie damit umgehen.

Überblick #

Die API erzwingt Ratenbegrenzungen, um eine faire Nutzung und Dienststabilität zu gewährleisten. Jeder API-Schlüssel ist auf 100 Anfragen pro Minute begrenzt.

Limit

100 requests per minute per API key. The window resets every 60 seconds.

Antwort bei Überschreitung #

Wenn Sie das Ratenlimit überschreiten, gibt die API eine 429 Too Many Requests-Antwort mit einem Retry-After-Header zurück:

429 Too Many Requests

json Response

HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json

{
  "status": 429,
  "title": "Too Many Requests",
  "detail": "Rate limit exceeded. Try again later."
}

Best Practices #

Um innerhalb der Ratenlimits zu bleiben:

Cachen Sie Antworten wenn möglich — vermeiden Sie redundante Anfragen für dieselben Daten
Verwenden Sie Paginierung — rufen Sie nur die Daten ab, die Sie benötigen, mit den Parametern page und pageSize
Implementieren Sie exponentielles Backoff — warten Sie nach Erhalt einer 429-Antwort, bevor Sie es erneut versuchen
Bündeln Sie Ihre Operationen — gruppieren Sie zusammengehörige Lesevorgänge, anstatt viele kleine Anfragen zu senden