DonateXdev.

ВойтиСоздать приложение

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

API DonateX

Публичный API DonateX: донаты, кружочки, управление алертами, цели, музыка и вебхуки. Авторизация, ошибки и примеры запросов на шести языках.

REST API и realtime-события DonateX позволяют встроить донаты в любой проект: собственный оверлей для OBS, бота для чата, панель модерации или аналитику канала. Всё, что стример делает кнопками в кабинете, можно делать запросами.

Базовый URL

https://donatex.gg/api

Realtime-хаб (SignalR)

https://donatex.gg/api/public-donations-hub

Быстрый старт

Первый ответ от API — за пару минут.

1

Получите токен

Для своего канала хватит external token: кабинет → Настройки → API и доступ. Делаете сервис для других стримеров — создайте OAuth-приложение. Подробнее — в разделе «Авторизация».

2

Сделайте запрос

Передайте токен в заголовке Authorization: Bearer и запросите профиль. Выберите язык — он запомнится для всей документации.

GET/v1/user/me
curl "https://donatex.gg/api/v1/user/me" \
  -H "Authorization: Bearer $DONATEX_TOKEN"
3

Слушайте донаты в реальном времени

Подключитесь к SignalR-хабу или подпишитесь на вебхуки — и получайте каждый донат, включая кружочки, в момент оплаты.

Что можно сделать

Донаты

История донатов стримера, тестовые донаты и объект доната с голосовыми сообщениями и кружочками.

Алерты

Скип текущего доната, скип по ID, очистка очереди и повтор доната через API DonateX.

Realtime

Получайте донаты, повторы и прогресс цели в реальном времени через публичный SignalR-хаб DonateX.

Вебхуки

Подписки на вебхуки DonateX, формат доставки, подпись HMAC-SHA256 и повторы.

Цели сбора

Активная цель сбора стримера: название, прогресс и сумма в рублях.

Музыка

Текущий трек музыкального виджета и его скип через API DonateX.

Соглашения

  • Запросы и ответы — JSON в UTF-8, имена полей в camelCase.
  • Даты — UTC в формате ISO 8601, например 2026-10-12T18:42:07Z.
  • Поля без значения не пропадают из ответа, а приходят как null.
  • Значения-перечисления — строки: NewestFirst, Last7Days.
  • Необязательные поля запроса не передавайте вовсе: null вместо числа, boolean или uuid вернёт 400.
  • Тип ошибки определяет HTTP-статус, причина — в теле ответа. Подробнее — в разделе «Ошибки».

Дальше

Что нового