Rate Limits & Fehler
Rate Limits, Antwort-Header und Fehlercodes verstehen.
Rate Limits nach Plan
| Plan | Tägliches Limit | Pro Sekunde |
|---|
| Kostenlos | 1,000 | 5 |
| Trader | 50,000 | 20 |
| Business | 500,000 | 50 |
Antwort-Header
Jede API-Antwort enthält Rate-Limit-Header, damit du deine Nutzung verfolgen kannst.
X-RateLimit-LimitMaximal erlaubte Anfragen im aktuellen Fenster.
X-RateLimit-RemainingVerbleibende Anfragen im aktuellen Fenster.
X-RateLimit-ResetUnix-Zeitstempel, wann das Rate-Limit-Fenster zuruckgesetzt wird.
Best Practices
- •Antworten cachen — Kartendaten und Preise ändern sich nicht jede Sekunde. Mindestens 5 Minuten cachen.
- •Batch-Abfragen nutzen — Bis zu 20 Karten pro Anfrage mit dem
ids-Parameter abrufen statt einzelner Aufrufe. - •Exponentiellen Backoff implementieren — Bei einem 429-Fehler warten und mit steigenden Verzögerungen erneut versuchen (1s, 2s, 4s).
- •Rate-Limit-Header überwachen — Überprüfe
X-RateLimit-Remaining, um proaktiv zu drosseln, bevor du Limits erreichst.