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

API только читает данные вашего канала: профиль, донаты, цели, топ донатеров и сумму за период. Записать или изменить что-то через него нельзя.

- [Где получить ключ](https://developers.staging.donatty.com/tokens.md)
- [Справочник API](https://developers.staging.donatty.com/reference.md)

### Бот или сервер

Секретный ключ с нужными правами. Пример на curl показывает последние донаты, отдельно описано, что можно выводить на стрим.

[Быстрый старт для бота](https://developers.staging.donatty.com/quickstart/bot.md)

### Статический сайт

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

[Быстрый старт для сайта](https://developers.staging.donatty.com/quickstart/website.md)

## Дальше

- [Ключи](https://developers.staging.donatty.com/tokens.md): какой ключ нужен, где его выпустить и как заменить.
- [Справочник API](https://developers.staging.donatty.com/reference.md): все пять маршрутов, кнопка «Попробовать запрос» отправляет запросы в https://api.staging.donatty.com.
- [Работа с данными](https://developers.staging.donatty.com/data.md): пустой список, страницы, деньги, время, отличие цели в API от виджета.
- [Лимиты запросов](https://developers.staging.donatty.com/rate-limits.md): четыре уровня и что делать после 429.
- [Ошибки](https://developers.staging.donatty.com/errors.md): у каждого кода из поля `type` своя страница.

Для программ: [llms.txt](https://developers.staging.donatty.com/llms.txt) со ссылками на всё нужное, [openapi.json](https://developers.staging.donatty.com/openapi.json) и Markdown-версия каждой страницы.