Snelheidsbeperking (Rate Limiting)
De Partner API hanteert snelheidslimieten om eerlijk gebruik en platformstabiliteit te waarborgen.
Standaardlimieten
| Endpoint | Limiet (Productie) | Limiet (Sandbox) |
|---|---|---|
| Algemene endpoints | 100 verzoeken/min | 500 verzoeken/min |
Bestelling aanmaken (POST /orders) | 10 verzoeken/min | 50 verzoeken/min |
Antwoordheaders
Elk API-antwoord bevat snelheidslimietinformatie in de volgende headers:
| Header | Beschrijving |
|---|---|
X-RateLimit-Limit | Maximaal aantal verzoeken toegestaan in het huidige venster |
X-RateLimit-Remaining | Aantal resterende verzoeken in het huidige venster |
X-RateLimit-Reset | Unix-tijdstempel (seconden) wanneer het snelheidslimietvenster wordt gereset |
Omgaan met 429-antwoorden
Wanneer u de snelheidslimiet overschrijdt, retourneert de API een 429 Too Many Requests-antwoord:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Aanbevolen strategie
- Lees de
X-RateLimit-Remaining-header om uw gebruik proactief te monitoren. - Wanneer u een
429ontvangt, wacht dan tot het tijdstip aangegeven doorX-RateLimit-Resetvoordat u het opnieuw probeert. - Implementeer exponentiële vertraging (exponential backoff) voor nieuwe pogingen om herhaalde beperking te voorkomen.
- Cache productcatalogusantwoorden waar mogelijk om onnodige verzoeken te verminderen.