Бот на Node.js
Бот раз в 5 секунд запрашивает новые донаты и печатает те, что можно показать на стриме. Один файл, без библиотек.
Что нужно
Заголовок раздела «Что нужно»- Node.js 18 или новее.
- Секретный ключ с правом
donations:readв переменнойDONATTY_TOKEN: как сохранить.
1. Сохраните код
Заголовок раздела «1. Сохраните код»Скопируйте код в файл bot.mjs.
const API = "https://api.donatty.com";const TOKEN = process.env.DONATTY_TOKEN;if (!TOKEN) { console.error("Задайте DONATTY_TOKEN: секретный ключ с правом donations:read"); process.exit(1);}
const SHOW = new Set(["NONE", "PASSED"]);const clean = text => String(text ?? "").replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029\u202a-\u202e\u2066-\u2069]/g, " "); // чужой ввод: управляющие символы → пробелconst shown = new Set(); // id уже показанных донатовconst waiting = new Map(); // id → createdAt донатов, по которым модерация ещё не решилаlet boundary = new Date(); // читаем донаты, созданные с момента запускаlet failures = 0;
async function get(url) { const res = await fetch(url, { headers: { Authorization: `Bearer ${TOKEN}` } }); if (res.ok) return res.json(); const problem = await res.json().catch(() => ({})); if (res.status === 401 || res.status === 403) { console.error(res.status, problem.code, problem.type); process.exit(1); } const error = new Error(`${res.status} ${problem.code ?? ""}`.trim()); error.retryAfter = res.status === 429 ? Number(res.headers.get("Retry-After") ?? 5) : null; throw error;}
// Один проход: все страницы окна с одними и теми же параметрами.async function readWindow() { const items = []; let cursor = null; do { const url = `${API}/v1/donations?limit=100&since=${boundary.toISOString()}` + (cursor ? `&cursor=${encodeURIComponent(cursor)}` : ""); const page = await get(url); items.push(...page.items); cursor = page.nextCursor; } while (cursor); return items;}
function handle(items) { const seen = new Set(); for (const d of items.reverse()) { // от старых к новым seen.add(d.id); if (d.moderation.status === "PENDING") { waiting.set(d.id, d.createdAt); continue; } waiting.delete(d.id); if (SHOW.has(d.moderation.status) && !shown.has(d.id)) { shown.add(d.id); const fee = d.feeCompensation ? ` (+${d.feeCompensation.value} ${d.feeCompensation.currency} за комиссию)` : ""; console.log(`${clean(d.donorName)} — ${d.amount.value} ${d.amount.currency}${fee}: ${clean(d.message)}`); } } for (const id of waiting.keys()) if (!seen.has(id)) waiting.delete(id); if (items.length > 0) { const newest = Math.max(...items.map(d => Date.parse(d.createdAt))) - 60_000; const oldestWaiting = Math.min(Infinity, ...[...waiting.values()].map(Date.parse)); boundary = new Date(Math.max(boundary, Math.min(newest, oldestWaiting))); }}
while (true) { let pause = 5; try { handle(await readWindow()); failures = 0; } catch (error) { failures += 1; pause = error.retryAfter ?? Math.min(2 ** failures, 60); console.error(error.message); } await new Promise(resolve => setTimeout(resolve, pause * 1000));}2. Запустите
Заголовок раздела «2. Запустите»В том же окне терминала, где вы сохранили ключ, перейдите в папку с файлом и выполните:
node bot.mjsЧто вы увидите
Заголовок раздела «Что вы увидите»Бот показывает донаты, которые пришли после запуска, поэтому сначала в терминале пусто. Каждый новый донат, который можно показать на стриме, появится строкой:
Alex — 500.00 RUB (+27.00 RUB за комиссию): Thanks for the stream!Если донатер доплатил за комиссию, доплата показана в скобках; без доплаты скобок нет.
Проверить бота можно только настоящим донатом: «Тест на стриме» в кабинете показывает оповещение, но доната не создаёт, и в API его нет.
Как это работает
Заголовок раздела «Как это работает»- Бот читает донаты без фильтра модерации: так не теряется донат, который сначала ждал решения, а потом прошёл. Ожидающие
PENDINGон запоминает и перечитывает, пока модерация не решит. - Выводятся только
NONEиPASSED.BLOCKEDи неизвестный статус бот не показывает. - Бот читает все страницы, пока
nextCursorне станетnull. Следующий проход он начинает с более раннего из двух моментов: создание самого старого доната со статусомPENDINGили создание самого нового доната минус минута. Уже показанные донаты пропускает поid. - После
429бот ждётRetry-After. На401и403бот останавливается и печатает код ошибки со ссылкой на её страницу. Там сказано, что сделать с ключом. На 5xx и сетевых ошибках повторяет с паузой 2, 4, 8… секунд, не дольше минуты. - Сумма — строка
valueи код валюты. Не переводите её в число с плавающей точкой. feeCompensation— доплата за комиссию в той же форме и валюте, илиnull;amountостаётся основной суммой.
Ограничения примера
Заголовок раздела «Ограничения примера»- После перезапуска бот начинает с текущего момента: что показано раньше, он не помнит.
- Донат, который появился в списке больше чем через минуту после своего создания, бот не увидит. Так бывает с донатами Donation Alerts после обрыва связи.
- Давно отклонённый донат, который вы вернули кнопкой «Повторить на стриме», бот тоже не увидит.
Что поменять
Заголовок раздела «Что поменять»- Замените
console.logна отправку в чат или в оверлей. Имя и текст перед этим очистите. - Пока новых донатов меньше 100, один проход — один запрос. Каждая следующая страница — ещё один запрос в счёт лимита.