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

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

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"
}

Skaitykite X-RateLimit-Remaining antraštę, kad proaktyviai stebėtumėte savo naudojimą.
Gavę 429 atsakymą, palaukite iki X-RateLimit-Reset nurodyto 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.