Limitowanie zapytan
API Partnerskie wymusza limity czestotliwosci zapytan (rate limiting), aby zapewnic sprawiedliwe uzytkowanie i stabilnosc platformy.
Domyslne limity
| Endpoint | Limit (Produkcja) | Limit (Sandbox) |
|---|---|---|
| Endpointy ogolne | 100 zapytan/min | 500 zapytan/min |
Tworzenie zamowien (POST /orders) | 10 zapytan/min | 50 zapytan/min |
Naglowki odpowiedzi
Kazda odpowiedz API zawiera informacje o limitach zapytan w nastepujacych naglowkach:
| Naglowek | Opis |
|---|---|
X-RateLimit-Limit | Maksymalna liczba zapytan dozwolonych w biezacym oknie czasowym |
X-RateLimit-Remaining | Liczba pozostalych zapytan w biezacym oknie czasowym |
X-RateLimit-Reset | Znacznik czasu Unix (sekundy), kiedy okno limitu zapytan zostanie zresetowane |
Obsluga odpowiedzi 429
Gdy przekroczysz limit zapytan, API zwraca odpowiedz 429 Too Many Requests:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Zalecana strategia
- Odczytuj naglowek
X-RateLimit-Remaining, aby proaktywnie monitorowac swoje zuzycie. - Gdy otrzymasz odpowiedz
429, poczekaj do czasu wskazanego przezX-RateLimit-Resetprzed ponowna proba. - Zaimplementuj wykladnicze wycofanie (exponential backoff) dla ponawianych prob, aby uniknac powtarzajacego sie throttlingu.
- Cachuj odpowiedzi katalogu produktow tam, gdzie to mozliwe, aby zmniejszyc liczbe niepotrzebnych zapytan.