Skip to main content
Rate Limiting wird auf den API-Key angewendet. Der öffentliche Vertrag definiert kein einheitliches numerisches Kontingent, das Clients fest codieren sollten. Lesen Sie die Response-Header, um die wirksame Richtlinie und aktuelle Verfügbarkeit zu ermitteln.

​
Response-Header

Eine Rate-Limit-Response verwendet HTTP 429 und RATE_LIMIT_EXCEEDED.

​
Behandlungsablauf

​
Empfehlungen für Clients

  • Codieren Sie kein Kontingent fest, das nicht durch die wirksamen Response-Header definiert wird.
  • Begrenzen Sie parallele Anfragen pro API-Key.
  • Teilen Sie den Rate-Limit-Zustand zwischen Workern, die denselben Key verwenden.
  • Verwenden Sie zufälligen Jitter, um synchronisierte Retries zu vermeiden.
  • Stoppen Sie Retries, sobald das Budget der Operation ausgeschöpft ist.
  • Trennen Sie Retry-Behandlung von Queues für fachliche Validierungsfehler.
  • Rotieren Sie Keys nicht, um Rate Limits zu umgehen.

​
Beispiel

Warten Sie mindestens 60 Sekunden, bevor Sie einen weiteren rate-limitierten Versuch mit dem betroffenen Key starten, und wenden Sie anschließend das Retry-Budget des Clients an.
Der OpenAPI-Vertrag beschreibt die Semantik der Header, aber keine kundenspezifischen oder dynamisch wirksamen Zahlenwerte. Behandeln Sie die Live-Response-Header als maßgeblich.
Zuletzt geändert am 27. August 2026