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