модули

Лимиты и квоты

Как устроен rate limiting в Hexly, что означают заголовки ответа и как правильно обрабатывать превышение лимита.

Заголовки ответа

Каждый ответ шлюза содержит заголовки с текущим состоянием лимита — используйте их, чтобы не приближаться к границе вслепую:

ЗаголовокЗначение
X-RateLimit-LimitОбщий лимит запросов в текущем окне
X-RateLimit-RemainingСколько запросов осталось до конца окна
X-RateLimit-ResetUnix-время сброса окна

Ответ при превышении

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Remaining: 0

{ "error": "rate_limit_exceeded", "retry_after": 12 }

Как правильно обрабатывать 429

  • Читайте заголовок Retry-After и ждите указанное время перед повтором — не повторяйте запрос немедленно.
  • Используйте экспоненциальную задержку с джиттером для дальнейших повторов, если 429 повторяется.
  • Логируйте частые 429 — это сигнал, что стоит либо оптимизировать частоту запросов, либо перейти на более высокий тариф.
i

Официальные SDK Hexly обрабатывают 429 автоматически — запрос будет повторён с учётом Retry-After без дополнительного кода с вашей стороны.

Лимиты по умолчанию

ТарифЗапросов в минуту на ключBurst
Free6010
Growth1 200200
Enterpriseнастраивается индивидуальнонастраивается индивидуально