Начало работы

Лимиты запросов

Ограничения частоты запросов к API DonateX и realtime-хабу и как не упираться в 429.

Лимиты на запросы

Лимит на стримера

Для external token — на токен. Для OAuth — на пару приложение + стример, поэтому стримеры одного приложения не мешают друг другу.

20 запросов/сек

600 запросов/мин

Общий лимит приложения

Только для OAuth: суммарно по всем стримерам приложения с одним client_id.

100 запросов/сек

3 000 запросов/мин

При превышении любого лимита вернётся 429 Too Many Requests с заголовком Retry-After — через сколько секунд можно повторить. Окна короткие, поэтому ждать придётся не больше минуты. Отклонённые запросы лимит не расходуют.

429 Too Many Requests · Retry-After: 12

{
  "error": "Rate limit exceeded",
  "retry_after": "Try again later"
}

Лимиты realtime-хаба

Подключения к /api/public-donations-hub ограничены 10 в секунду с одного IP. Держите одно долгоживущее соединение с автоматическим переподключением вместо того, чтобы открывать новое на каждое событие.

Как не упираться в лимиты

Не опрашивайте /v1/donations по таймеру — новые донаты приходят через realtime-хаб и вебхуки мгновенно.
Кешируйте редко меняющиеся данные: профиль, ИИ-персонажей, список подписок.
Делайте запросы с сервера, а не из каждого браузера зрителя: общий лимит приложения один на всех.
При 429 подождите столько секунд, сколько указано в Retry-After, и повторите.

Ошибки

Дальше

Донаты