Rate limiting и квоты

Лимиты по разным измерениям

Ограничивайте частоту запросов по API-ключу, IP-адресу, пользователю или тарифному плану клиента — можно комбинировать несколько правил для одного маршрута.

Скользящее окно

Вместо жёсткого окна в фиксированный интервал Hexly использует скользящее окно — это сглаживает всплески на границах минуты и точнее отражает реальную нагрузку.

Всплески нагрузки

Настройте допустимый burst поверх базового лимита — кратковременные всплески не блокируются, если средняя нагрузка остаётся в пределах нормы.

Понятные ответы клиенту

При превышении лимита клиент получает 429 с заголовками Retry-After и текущим остатком квоты — интеграция может корректно обработать ограничение вместо повторных попыток вслепую.

Настройка лимита по тарифному плану клиента

rate_limits:
  - route: /v1/search
    by: api_key
    limit: 100/min
    burst: 20
    tiers:
      free: 100/min
      growth: 2000/min