Rate Limits & Fehler
Rate Limits, Antwort-Header und Fehlercodes verstehen.
Rate Limits nach Plan
| Plan | Tägliches Limit | Pro Sekunde |
|---|
| Kostenlos | 200 | 1 req / 3s |
| Trader | 10,000 | 1 req / s |
| Business | 100,000 | 3 req / s |
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.
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.