/

Обновления Донатти

Публичный API Донатти: свой бот о донатах и сборах

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

Юрий Медяков

Продакт-менеджер Donatty

Опубликовано:

Донатти выпустил публичный API

Мы выпустили публичный API Донатти. Теперь донаты, цели и топ донатеров вашего канала можно забирать в свою программу: в бота, на свой сайт или в другой сервис. В ролике всё за минуту, ниже — подробнее.

Бот о донатах и сборах

Сделайте себе бота: он будет писать о новых донатах, сборах и топе донатеров в Telegram или куда угодно.

В документации есть готовый бот на Node.js и Python. Раз в 5 секунд он забирает новые донаты и оставляет только те, что прошли модерацию или не требовали её. Отклонённые донаты он не покажет.

Виджет сбора на своём сайте

Покажите на своей странице, сколько уже собрано на цель. Готовая страница с целью — это один HTML-файл: на ней название цели, собранная сумма и полоска, данные обновляются раз в 30 секунд. Такую страницу можно добавить и в OBS источником «Браузер».

Кроме цели, на сайте можно показать топ донатеров или сумму донатов за период.

Связка с другим сервисом

Донаты, цели и топ можно передать в любой сервис, которым вы пользуетесь. Например, от доната загорается умная лампа.

Какие данные открывает API

  • донаты — все, от новых к старым, со статусом модерации;

  • цели сбора — название, цель и собранная сумма;

  • топ донатеров за день, неделю, месяц, год или всё время;

  • сумма донатов за период;

  • профиль — ник, аватар и ссылка на страницу доната.

API только читает данные: вывести деньги или что-то изменить через него нельзя. Ключ открывает данные только вашего канала.

С чего начать

  1. Выпустите ключ в кабинете, в разделе «Разработчикам». Для бота или сервера — секретный: при выпуске вы отмечаете, что ему можно читать. Для сайта — публичный: он открывает только профиль, цели и статистику, донаты не читает.

  2. Возьмите готовый пример из документации: бот на Node.js или Python, страницу с целью сбора.

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

Значение секретного ключа мы показываем один раз — скопируйте его сразу.

Скоро: WebSocket и OAuth

В разработке WebSocket API и OAuth для разработчиков приложений. Планируем выпустить их скоро.

Документация

Ключи, методы, ошибки, лимиты и частые вопросы — на developers.donatty.com.

Зарегистрируйтесь и получайте донаты

Зарегистрируйтесь и получайте донаты

Зарегистрируйтесь и получайте донаты

Настраивайте свою страницу доната, показывайте донат алерты на стриме, и выводите деньги на банковскую карту.

Настраивайте свою страницу доната, показывайте донат алерты на стриме, и выводите деньги на банковскую карту.

Login Screenshot