Ограничение на заявки
Партньорският 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) при повторни опити, за да избегнете повторно регулиране.
- Кеширайте отговорите от каталога на продукти, когато е възможно, за да намалите ненужните заявки.