Перейти к содержимому

Частые вопросы

Проще всего готовыми виджетами из кабинета. Для своего оверлея нужен ваш сервер: он запрашивает донаты с секретным ключом и передаёт их странице оверлея. Сам ключ в страницу и в OBS не вставляйте: его увидит любой, кто откроет страницу.

Цель, топ или сумму донатов можно показать и без сервера, страницей с публичным ключом. В OBS её добавляют источником «Браузер»: быстрый старт «Сайт».

«Тест на стриме» в кабинете только показывает оповещение: сам донат при этом не создаётся, поэтому в API его нет. Проверить бота можно настоящим донатом.

Чтобы убедиться, что ключ и запрос работают, донат не нужен: хватит ответа со статусом 200, даже с пустым списком.

Под условия запроса ничего не подошло: донатов или целей пока нет, или их отсекли фильтры moderation, since, source или status. Ответ "items": [] со статусом 200 — успешный, ключ в порядке.

Уберите фильтры и повторите запрос. Тестовые донаты в список не попадают: почему.

Почему бот показал донат, который я отклонил?

Заголовок раздела «Почему бот показал донат, который я отклонил?»

API отдаёт все донаты, включая отклонённые модерацией, и фильтры ваших виджетов к нему не применяются. Что показывать, решает ваш бот: показывайте донаты без модерации (NONE) и пропущенные ею (PASSED), а те, что ждут решения (PENDING), перечитывайте, пока статус не сменится. Статус приходит в поле moderation.status.

Готовые боты на Node.js и Python так и делают. Подробнее: что показывать на стриме.

Нет, уведомлений (webhook) в API нет: бот узнаёт о новых донатах, когда сам их запрашивает. Если ответ помещается в одну страницу, запрос раз в 5 секунд — это 12 запросов в минуту при лимите 600.

Так работают готовые боты на Node.js и Python. Донаты, которые ждут модерации, они перечитывают сами.

Скорее всего, адреса вашей страницы нет в списке адресов публичного ключа. Ответ API origin_not_allowed браузер странице не показывает, видна только сетевая ошибка.

В кабинете нажмите «Настроить ключ» у публичного ключа и добавьте адрес так, как он написан в адресной строке: протокол, домен и порт. Страница, открытая из файла, не подойдёт: нужен адрес http:// или https://. Подробнее — на странице ошибки origin_not_allowed.

Если ключ работал, а потом перестал, скорее всего, вышел его срок: в ответе придёт код token_expired. Срок не продлевается. Выпустите новый ключ, вставьте его в бот и удалите старый: как заменить ключ.

Если в ответе invalid_token, ключ удалён, скопирован не целиком или в запросе осталась заглушка из примера, например dnt_pat_....

Что делать, если секретный ключ увидел кто-то чужой?

Заголовок раздела «Что делать, если секретный ключ увидел кто-то чужой?»

Выпустите новый ключ и сразу удалите старый: удаление срабатывает в течение минуты. Потом вставьте новый ключ в бот. Подробнее: «Ключи».

Публичный ключ прятать не нужно: его и так видят посетители сайта, а читает он только профиль, цели и статистику.

Секретными ключами — до 600 запросов в минуту на все ключи вместе. Публичным ключом — до 60 запросов в минуту с одного IP-адреса и до 600 в минуту со всех адресов вместе.

Один запрос раз в 30 секунд — два запроса в минуту с каждой открытой страницы. Все страницы делят лимит 600, а страницы с одного IP-адреса — ещё и лимит 60. Когда лимит кончится, придёт ответ 429: что делать.

Почему сумма цели не такая, как на виджете?

Заголовок раздела «Почему сумма цели не такая, как на виджете?»

API считает собранное (raised) так: сумма, с которой вы начали сбор (поле «Начать сбор с»), плюс все донаты Донатти в эту цель, включая отклонённые модерацией. Цели Donation Alerts и настройки виджета API не учитывает. Подробнее: «Работа с данными».

Да, если Donation Alerts подключён в кабинете, в блоке «Подключённые аккаунты», и у вас подписка ПРО. У таких донатов source равен DONATION_ALERTS. Подписок и битов Twitch в API нет.

На любом, который умеет отправлять HTTP-запросы. Готовые боты есть на Node.js и Python, а пример запроса на странице каждого метода переключается на Shell, Node.js, Python, PHP и Ruby.

Можно ли получать донаты другого стримера?

Заголовок раздела «Можно ли получать донаты другого стримера?»

Только с его ключом: ключ открывает данные того канала, в чьём кабинете он выпущен. Если вы делаете бота для другого стримера, пусть он выпустит секретный ключ у себя и вставит его в настройки бота. Входа через Донатти (OAuth) для сторонних сервисов нет.

Донатер не указал имя. У доната Донатти поле donorName тогда равно Anonymous, пустым оно не бывает. Если хотите показывать «Аноним», замените это значение в своём коде.

Можно ли через API вывести деньги или изменить данные?

Заголовок раздела «Можно ли через API вывести деньги или изменить данные?»

Нет. API только читает данные: баланса и вывода средств в нём нет. Вывести деньги можно в кабинете, кнопкой «Вывести средства».