Бот или сервер
Что понадобится: полная сессия в кабинете Донатти и место, где работает ваша программа (бот, сервер или скрипт). Первый запрос читает последние донаты.
1. Выпустите секретный ключ
Заголовок раздела «1. Выпустите секретный ключ»Откройте раздел «Разработчикам», в блоке «Секретные ключи» нажмите «Выпустить секретный ключ». Введите название, отметьте право donations:read (для этого примера достаточно его), выберите срок и нажмите «Выпустить ключ».
Секретный ключ показывают один раз. Сохраните его в секретах программы или в переменной окружения DONATTY_TOKEN, а не в коде. Подробнее: ключи.
2. Получите последние донаты
Заголовок раздела «2. Получите последние донаты»curl -s https://api.staging.donatty.com/v1/donations?limit=5 \ -H "Authorization: Bearer $DONATTY_TOKEN"GET /v1/donations (право donations:read) отдаёт все донаты от новых к старым, включая
отклонённые модерацией и ожидающие её решения, с полным текстом и статусом moderation.status:
| статус | значит | что делать оверлею |
|---|---|---|
NONE |
модерации не было (выключена, донат Donation Alerts) | показать |
PASSED |
пропущен модерацией или «Повторить на стриме» | показать |
PENDING |
модерация идёт, решение по умолчанию — в moderation.deadline |
подождать и перечитать |
BLOCKED |
отклонён модерацией | не показывать |
Только показываемые: GET /v1/donations?moderation=PASSED,NONE. Другие отборы: since (RFC 3339, с
этого момента включительно), source=DONATTY|DONATION_ALERTS.
Если донатов ещё не было, ответ приходит со статусом 200 и пустым списком: "items": []. Это успешный ответ.
3. Читайте дальше
Заголовок раздела «3. Читайте дальше»Страницы, форматы денег и времени разобраны в разделе «Работа с данными». Не уложились в лимит или получили отказ: лимиты запросов и список ошибок. Все маршруты, параметры и ответы: справочник API.