Обмеження запитів (Rate Limiting)
Partner API застосовує обмеження частоти запитів для забезпечення справедливого використання та стабільності платформи.
Ліміти за замовчуванням
| Ендпоінт | Ліміт (Продакшн) | Ліміт (Пісочниця) |
|---|---|---|
| Загальні ендпоінти | 100 запитів/хв | 500 запитів/хв |
Створення замовлення (POST /orders) | 10 запитів/хв | 50 запитів/хв |
Заголовки відповіді
Кожна API-відповідь містить інформацію про обмеження запитів у наступних заголовках:
| Заголовок | Опис |
|---|---|
X-RateLimit-Limit | Максимальна кількість запитів, дозволених у поточному вікні |
X-RateLimit-Remaining | Кількість запитів, що залишилися у поточному вікні |
X-RateLimit-Reset | Мітка часу Unix (секунди), коли вікно обмеження скидається |
Обробка відповідей 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) для повторних спроб, щоб уникнути повторного дроселювання.
- Кешуйте відповіді каталогу продуктів, де це можливо, щоб зменшити кількість непотрібних запитів.