Ограничение на заявки

Партньорският API (Partner API) прилага ограничения на честотата на заявките (rate limits), за да осигури справедливо използване и стабилност на платформата.

Ограничения по подразбиране

Крайна точка	Лимит (Продукция)	Лимит (Sandbox)
Общи крайни точки	100 заявки/мин	500 заявки/мин
Създаване на поръчка (`POST /orders`)	10 заявки/мин	50 заявки/мин

Хедъри в отговора

Всеки API отговор включва информация за ограничението на заявки в следните хедъри:

Header	Описание
`X-RateLimit-Limit`	Максимален брой позволени заявки в текущия прозорец
`X-RateLimit-Remaining`	Оставащ брой заявки в текущия прозорец
`X-RateLimit-Reset`	Unix timestamp (секунди), когато прозорецът за ограничение се нулира

Обработка на отговори 429

Когато надвишите ограничението на заявки, API-то връща отговор 429 Too Many Requests:

{
	"statusCode": 429,
	"message": "Rate limit exceeded. Try again in 45 seconds.",
	"error": "Too Many Requests"
}

Препоръчителна стратегия

Четете хедъра X-RateLimit-Remaining, за да следите проактивно използването си.
Когато получите отговор 429, изчакайте до времето, посочено в X-RateLimit-Reset, преди да опитате отново.
Имплементирайте експоненциално забавяне (exponential backoff) при повторни опити, за да избегнете повторно регулиране.
Кеширайте отговорите от каталога на продукти, когато е възможно, за да намалите ненужните заявки.