Ratenbegrenzung (Rate Limiting)
Die Partner-API erzwingt Ratenbegrenzungen, um eine faire Nutzung und Plattformstabilität zu gewährleisten.
Standardlimits
| Endpunkt | Limit (Produktion) | Limit (Sandbox) |
|---|---|---|
| Allgemeine Endpunkte | 100 Anfragen/Min | 500 Anfragen/Min |
Bestellerstellung (POST /orders) | 10 Anfragen/Min | 50 Anfragen/Min |
Antwort-Header
Jede API-Antwort enthält Informationen zur Ratenbegrenzung in den folgenden Headern:
| Header | Beschreibung |
|---|---|
X-RateLimit-Limit | Maximale Anzahl erlaubter Anfragen im aktuellen Zeitfenster |
X-RateLimit-Remaining | Verbleibende Anzahl von Anfragen im aktuellen Zeitfenster |
X-RateLimit-Reset | Unix-Zeitstempel (Sekunden), wann das Ratenbegrenzungs-Zeitfenster zurückgesetzt wird |
Umgang mit 429-Antworten
Wenn Sie die Ratenbegrenzung überschreiten, gibt die API eine 429 Too Many Requests-Antwort zurück:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Empfohlene Strategie
- Lesen Sie den
X-RateLimit-Remaining-Header, um Ihre Nutzung proaktiv zu überwachen. - Wenn Sie eine
429-Antwort erhalten, warten Sie bis zu dem imX-RateLimit-Resetangegebenen Zeitpunkt, bevor Sie es erneut versuchen. - Implementieren Sie exponentielles Backoff für Wiederholungsversuche, um wiederholte Drosselung zu vermeiden.
- Cachen Sie Produktkatalog-Antworten, wo möglich, um unnötige Anfragen zu reduzieren.