Užklausų ribojimas
Partnerių API (Partner API) taiko užklausų dažnio limitus, siekdama užtikrinti sąžiningą naudojimą ir platformos stabilumą.
Numatytieji limitai
| Galinis taškas | Limitas (produkcija) | Limitas (sandbox) |
|---|---|---|
| Bendrieji galiniai taškai | 100 užklausų/min | 500 užklausų/min |
Užsakymo kūrimas (POST /orders) | 10 užklausų/min | 50 užklausų/min |
Atsakymo antraštės
Kiekvienas API atsakymas apima užklausų limito informaciją šiose antraštėse:
| Antraštė | Aprašymas |
|---|---|
X-RateLimit-Limit | Maksimalus leidžiamų užklausų skaičius dabartiniame lange |
X-RateLimit-Remaining | Likusių užklausų skaičius dabartiniame lange |
X-RateLimit-Reset | Unix laiko žyma (sekundėmis), kada užklausų limito langas atsinaujina |
429 atsakymų apdorojimas
Viršijus užklausų limitą, API grąžina 429 Too Many Requests atsakymą:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Rekomenduojama strategija
- Skaitykite
X-RateLimit-Remainingantraštę, kad proaktyviai stebėtumėte savo naudojimą. - Gavę
429atsakymą, palaukite ikiX-RateLimit-Resetnurodyto laiko prieš bandydami pakartotinai. - Įgyvendinkite eksponentinį atsitraukimą (exponential backoff) pakartotinėms užklausoms, kad išvengtumėte pasikartojančio ribojimo.
- Kešuokite produktų katalogo atsakymus, kai įmanoma, kad sumažintumėte nereikalingas užklausas.