Руководство
Markdown-версияЛимиты и ограничения
Сколько запросов можно делать и какие есть ограничения на данные.
| Ограничение | Значение |
|---|---|
| Запросы с одного IP (все, кроме /health/api) | 600 за 15 минут |
| Запросы одного клиента (по ключу) | 150 за 15 минут |
| Песочница с одного IP, дополнительно | 30 за 15 минут |
| Тело запроса | 10 КБ, только application/json |
| X-Entity-Key · idempotencyKey · webhookUrl | 128 · 128 · 2048 символов |
Превышение лимита — 429 Too many requests, try again later. Окно фиксированное: счётчик обнуляется через 15 минут после первого запроса в окне. Значения могут меняться — не стройте логику на точных числах.
Как не упираться в лимит
- Кэшируйте каталог:
GET /productsу нас и так обновляется раз в 10 минут. - Ждите вебхук вместо частого опроса заказов; если опрашиваете — не чаще раза в 5–10 секунд.
- Не проверяйте наличие всех товаров подряд — только того, который покупаете.
Блокировки
Многократные запросы к несуществующим адресам без действующего ключа воспринимаются как сканирование: IP временно блокируется (403 IP banned).
Технические работы
Во время работ все запросы, кроме /health/api, получают 503 с "code": "maintenance_mode" и заголовком X-Maintenance-Mode: 1. Повторите позже.