Частые вопросы
Как показать донаты в OBS?
Заголовок раздела «Как показать донаты в OBS?»Проще всего готовыми виджетами из кабинета. Для своего оверлея нужен ваш сервер: он запрашивает донаты с секретным ключом и передаёт их странице оверлея. Сам ключ в страницу и в OBS не вставляйте: его увидит любой, кто откроет страницу.
Цель, топ или сумму донатов можно показать и без сервера, страницей с публичным ключом. В OBS её добавляют источником «Браузер»: быстрый старт «Сайт».
Почему тестовый донат не пришёл в API?
Заголовок раздела «Почему тестовый донат не пришёл в API?»«Тест на стриме» в кабинете только показывает оповещение: сам донат при этом не создаётся, поэтому в 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. Донаты, которые ждут модерации, они перечитывают сами.
Почему браузер пишет CORS или Failed to fetch?
Заголовок раздела «Почему браузер пишет CORS или Failed to fetch?»Скорее всего, адреса вашей страницы нет в списке адресов публичного ключа. Ответ 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?
Заголовок раздела «Приходят ли донаты Donation Alerts?»Да, если Donation Alerts подключён в кабинете, в блоке «Подключённые аккаунты», и у вас подписка ПРО. У таких донатов source равен DONATION_ALERTS. Подписок и битов Twitch в API нет.
На каком языке можно писать бота?
Заголовок раздела «На каком языке можно писать бота?»На любом, который умеет отправлять HTTP-запросы. Готовые боты есть на Node.js и Python, а пример запроса на странице каждого метода переключается на Shell, Node.js, Python, PHP и Ruby.
Можно ли получать донаты другого стримера?
Заголовок раздела «Можно ли получать донаты другого стримера?»Только с его ключом: ключ открывает данные того канала, в чьём кабинете он выпущен. Если вы делаете бота для другого стримера, пусть он выпустит секретный ключ у себя и вставит его в настройки бота. Входа через Донатти (OAuth) для сторонних сервисов нет.
Почему у доната имя Anonymous?
Заголовок раздела «Почему у доната имя Anonymous?»Донатер не указал имя. У доната Донатти поле donorName тогда равно Anonymous, пустым оно не бывает. Если хотите показывать «Аноним», замените это значение в своём коде.
Можно ли через API вывести деньги или изменить данные?
Заголовок раздела «Можно ли через API вывести деньги или изменить данные?»Нет. API только читает данные: баланса и вывода средств в нём нет. Вывести деньги можно в кабинете, кнопкой «Вывести средства».