# Частые вопросы

## Как показать донаты в OBS?

Проще всего готовыми виджетами из кабинета. Для своего оверлея нужен ваш сервер: он запрашивает донаты с секретным ключом и передаёт их странице оверлея. Сам ключ в страницу и в OBS не вставляйте: его увидит любой, кто откроет страницу.

Цель, топ или сумму донатов можно показать и без сервера, страницей с публичным ключом. В OBS её добавляют источником «Браузер»: [быстрый старт «Сайт»](https://developers.donatty.com/quickstart/website.md).

## Почему тестовый донат не пришёл в API?

«Тест на стриме» в кабинете только показывает оповещение: сам донат при этом не создаётся, поэтому в API его нет. Проверить бота можно настоящим донатом.

Чтобы убедиться, что ключ и запрос работают, донат не нужен: хватит ответа со статусом 200, даже с пустым списком.

## Почему пришёл пустой список?

Под условия запроса ничего не подошло: донатов или целей пока нет, или их отсекли фильтры `moderation`, `since`, `source` или `status`. Ответ `"items": []` со статусом 200 — успешный, ключ в порядке.

Уберите фильтры и повторите запрос. Тестовые донаты в список не попадают: [почему](#почему-тестовый-донат-не-пришёл-в-api).

## Почему бот показал донат, который я отклонил?

API отдаёт все донаты, включая отклонённые модерацией, и фильтры ваших виджетов к нему не применяются. Что показывать, решает ваш бот: показывайте донаты без модерации (`NONE`) и пропущенные ею (`PASSED`), а те, что ждут решения (`PENDING`), перечитывайте, пока статус не сменится. Статус приходит в поле `moderation.status`.

Готовые боты на [Node.js](https://developers.donatty.com/examples/bot-node.md) и [Python](https://developers.donatty.com/examples/bot-python.md) так и делают. Подробнее: [что показывать на стриме](https://developers.donatty.com/quickstart/bot.md#что-показывать-на-стриме).

## Есть ли вебхуки?

Нет, уведомлений (webhook) в API нет: бот узнаёт о новых донатах, когда сам их запрашивает. Если ответ помещается в одну страницу, запрос раз в 5 секунд — это 12 запросов в минуту при лимите 600.

Так работают готовые боты на [Node.js](https://developers.donatty.com/examples/bot-node.md) и [Python](https://developers.donatty.com/examples/bot-python.md). Донаты, которые ждут модерации, они перечитывают сами.

## Почему браузер пишет CORS или Failed to fetch?

Скорее всего, адреса вашей страницы нет в списке адресов публичного ключа. Ответ API `origin_not_allowed` браузер странице не показывает, видна только сетевая ошибка.

В кабинете нажмите «Настроить ключ» у публичного ключа и добавьте адрес так, как он написан в адресной строке: протокол, домен и порт. Страница, открытая из файла, не подойдёт: нужен адрес `http://` или `https://`. Подробнее — на странице ошибки [origin_not_allowed](https://developers.donatty.com/errors/origin_not_allowed.md).

## Почему ключ перестал работать?

Если ключ работал, а потом перестал, скорее всего, вышел его срок: в ответе придёт код `token_expired`. Срок не продлевается. Выпустите новый ключ, вставьте его в бот и удалите старый: [как заменить ключ](https://developers.donatty.com/tokens.md#замените-секретный-ключ).

Если в ответе `invalid_token`, ключ удалён, скопирован не целиком или в запросе осталась заглушка из примера, например `dnt_pat_...`.

## Что делать, если секретный ключ увидел кто-то чужой?

Выпустите новый ключ и сразу удалите старый: удаление срабатывает в течение минуты. Потом вставьте новый ключ в бот. Подробнее: [«Ключи»](https://developers.donatty.com/tokens.md#замените-секретный-ключ).

Публичный ключ прятать не нужно: его и так видят посетители сайта, а читает он только профиль, цели и статистику.

## Как часто можно отправлять запросы?

Секретными ключами — до 600 запросов в минуту на все ключи вместе. Публичным ключом — до 60 запросов в минуту с одного IP-адреса и до 600 в минуту со всех адресов вместе.

Один запрос раз в 30 секунд — два запроса в минуту с каждой открытой страницы. Все страницы делят лимит 600, а страницы с одного IP-адреса — ещё и лимит 60. Когда лимит кончится, придёт ответ 429: [что делать](https://developers.donatty.com/rate-limits.md#что-делать-после-429).

## Почему сумма цели не такая, как на виджете?

API считает собранное (`raised`) так: сумма, с которой вы начали сбор (поле «Начать сбор с»), плюс все донаты Донатти в эту цель, включая отклонённые модерацией. Цели Donation Alerts и настройки виджета API не учитывает. Подробнее: [«Работа с данными»](https://developers.donatty.com/data.md).

## Приходят ли донаты Donation Alerts?

Да, если Donation Alerts подключён в кабинете, в блоке «Подключённые аккаунты», и у вас подписка ПРО. У таких донатов `source` равен `DONATION_ALERTS`. Подписок и битов Twitch в API нет.

## На каком языке можно писать бота?

На любом, который умеет отправлять HTTP-запросы. Готовые боты есть на [Node.js](https://developers.donatty.com/examples/bot-node.md) и [Python](https://developers.donatty.com/examples/bot-python.md), а пример запроса на странице каждого метода переключается на Shell, Node.js, Python, PHP и Ruby.

## Можно ли получать донаты другого стримера?

Только с его ключом: ключ открывает данные того канала, в чьём кабинете он выпущен. Если вы делаете бота для другого стримера, пусть он выпустит секретный ключ у себя и вставит его в настройки бота. Входа через Донатти (OAuth) для сторонних сервисов нет.

## Почему у доната имя Anonymous?

Донатер не указал имя. У доната Донатти поле `donorName` тогда равно `Anonymous`, пустым оно не бывает. Если хотите показывать «Аноним», замените это значение в своём коде.

## Можно ли через API вывести деньги или изменить данные?

Нет. API только читает данные: баланса и вывода средств в нём нет. Вывести деньги можно в кабинете, кнопкой «Вывести средства».
