# Лимиты и ограничения

Сколько запросов можно делать и какие есть ограничения на данные.

| Ограничение | Значение |
|---|---|
| Запросы с одного 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`. Повторите позже.