Публичный API Донатти: свой бот о донатах и сборах
Донаты, цели и топ донатеров вашего канала теперь можно забирать в свою программу: в бота, на свой сайт или в другой сервис. Рассказываем, что можно сделать и с чего начать.

Продакт-менеджер Donatty
Опубликовано:

Мы выпустили публичный API Донатти. Теперь донаты, цели и топ донатеров вашего канала можно забирать в свою программу: в бота, на свой сайт или в другой сервис. В ролике всё за минуту, ниже — подробнее.
Бот о донатах и сборах
Сделайте себе бота: он будет писать о новых донатах, сборах и топе донатеров в Telegram или куда угодно.
В документации есть готовый бот на Node.js и Python. Раз в 5 секунд он забирает новые донаты и оставляет только те, что прошли модерацию или не требовали её. Отклонённые донаты он не покажет.
Виджет сбора на своём сайте
Покажите на своей странице, сколько уже собрано на цель. Готовая страница с целью — это один HTML-файл: на ней название цели, собранная сумма и полоска, данные обновляются раз в 30 секунд. Такую страницу можно добавить и в OBS источником «Браузер».
Кроме цели, на сайте можно показать топ донатеров или сумму донатов за период.
Связка с другим сервисом
Донаты, цели и топ можно передать в любой сервис, которым вы пользуетесь. Например, от доната загорается умная лампа.
Какие данные открывает API
донаты — все, от новых к старым, со статусом модерации;
цели сбора — название, цель и собранная сумма;
топ донатеров за день, неделю, месяц, год или всё время;
сумма донатов за период;
профиль — ник, аватар и ссылка на страницу доната.
API только читает данные: вывести деньги или что-то изменить через него нельзя. Ключ открывает данные только вашего канала.
С чего начать
Выпустите ключ в кабинете, в разделе «Разработчикам». Для бота или сервера — секретный: при выпуске вы отмечаете, что ему можно читать. Для сайта — публичный: он открывает только профиль, цели и статистику, донаты не читает.
Возьмите готовый пример из документации: бот на Node.js или Python, страницу с целью сбора.
Для своей идеи начните с быстрого старта — для бота или для сайта. Примеры запросов есть на главной документации, а на странице каждого метода пример переключается на Shell, Node.js, Python, PHP и Ruby.
Значение секретного ключа мы показываем один раз — скопируйте его сразу.
Скоро: WebSocket и OAuth
В разработке WebSocket API и OAuth для разработчиков приложений. Планируем выпустить их скоро.
Документация
Ключи, методы, ошибки, лимиты и частые вопросы — на developers.donatty.com.
Ещё по теме

Программа амбассадоров Донатти: тариф PRO бесплатно
Рассказываете о Донатти своей аудитории — мы дарим вам тариф PRO. Подходит любой канал от 100 подписчиков. Рассказываем, что входит в PRO, что нужно делать и как вступить.
Подробнее

Релиз от 7 ноября: компенсация комиссии и два новых алерта
Компенсация комиссии теперь видна в Финансах, а для донатов с компенсацией и донатов с медиа можно сделать отдельный алерт. Показываем в ролике и рассказываем, как настроить.
Подробнее

ТикТок: недооценённый инструмент продвижения для стримера
Рассказываем как работают алгоритмы ТикТока и почему стримеру есть смысл продвигаться в соцсети TikTok.
Подробнее

