# API Донатти

> Данные одного стримера Донатти, только чтение: профиль, донаты, цели, топ донатеров и суммы.

- Среда: staging
- Сайт документации: https://developers.staging.donatty.com/
- API: https://api.staging.donatty.com
- Кабинет: https://streamer.staging.donatty.com

## Для программ

- [OpenAPI 3.1: все маршруты, параметры и ответы](https://developers.staging.donatty.com/openapi.json)
- [Полный текст документации одним файлом](https://developers.staging.donatty.com/llms-full.txt)

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

- [Бот или сервер](https://developers.staging.donatty.com/quickstart/bot.md): Быстрый старт для бота или сервера. Выпустить секретный ключ и получить последние донаты запросом curl.
- [Статический сайт](https://developers.staging.donatty.com/quickstart/website.md): Быстрый старт для сайта. Выпустить публичный ключ, указать адрес сайта и загрузить профиль, цели или топ донатеров из браузера.

## Пример: последние донаты

```bash
curl -s "https://api.staging.donatty.com/v1/donations?limit=5" -H "Authorization: Bearer $DONATTY_TOKEN"
```

## Все страницы в Markdown

- [Документация API Донатти](https://developers.staging.donatty.com/index.md): Публичный API Донатти: где получить ключ, как сделать первый запрос и что значит ошибка.
- [Ключи](https://developers.staging.donatty.com/tokens.md): Какой ключ нужен боту, а какой сайту, где его выпустить, как хранить и как заменить.
- [Быстрый старт](https://developers.staging.donatty.com/quickstart.md): Два пути к первому ответу API: бот или сервер с секретным ключом и статический сайт с публичным ключом.
- [Бот или сервер](https://developers.staging.donatty.com/quickstart/bot.md): Быстрый старт для бота или сервера. Выпустить секретный ключ и получить последние донаты запросом curl.
- [Статический сайт](https://developers.staging.donatty.com/quickstart/website.md): Быстрый старт для сайта. Выпустить публичный ключ, указать адрес сайта и загрузить профиль, цели или топ донатеров из браузера.
- [Справочник API](https://developers.staging.donatty.com/reference.md): Пять маршрутов публичного API: права, параметры, ответы и пример запроса из браузера.
- [Работа с данными](https://developers.staging.donatty.com/data.md): Пустой список, страницы, форматы денег и времени, отличие цели в API от виджета, что показывает статистика.
- [Лимиты запросов](https://developers.staging.donatty.com/rate-limits.md): Четыре уровня лимита, заголовки RateLimit и Retry-After, что делать после ответа 429.
- [Ошибки](https://developers.staging.donatty.com/errors.md): Коды ошибок публичного API: что значит каждый и что делать.
- [missing_token](https://developers.staging.donatty.com/errors/missing_token.md): HTTP-статус 401: в запросе нет ключа.
- [invalid_token](https://developers.staging.donatty.com/errors/invalid_token.md): HTTP-статус 401: ключ не найден или повреждён.
- [token_expired](https://developers.staging.donatty.com/errors/token_expired.md): HTTP-статус 401: срок ключа вышел.
- [token_in_query](https://developers.staging.donatty.com/errors/token_in_query.md): HTTP-статус 400: ключ передан в адресе запроса.
- [wrong_token_type](https://developers.staging.donatty.com/errors/wrong_token_type.md): HTTP-статус 403: это не ключ для публичного API.
- [insufficient_scope](https://developers.staging.donatty.com/errors/insufficient_scope.md): HTTP-статус 403: у ключа нет нужного права.
- [origin_not_allowed](https://developers.staging.donatty.com/errors/origin_not_allowed.md): HTTP-статус 403: адрес сайта не разрешён этому ключу.
- [invalid_parameter](https://developers.staging.donatty.com/errors/invalid_parameter.md): HTTP-статус 400: значение параметра не подходит.
- [not_found](https://developers.staging.donatty.com/errors/not_found.md): HTTP-статус 404: такого маршрута нет.
- [rate_limited](https://developers.staging.donatty.com/errors/rate_limited.md): HTTP-статус 429: исчерпан лимит запросов.
- [internal_error](https://developers.staging.donatty.com/errors/internal_error.md): HTTP-статус 500: запрос не удался на стороне Донатти.
- [service_unavailable](https://developers.staging.donatty.com/errors/service_unavailable.md): HTTP-статус 503: API временно недоступен.

## Другой язык

- [English](https://developers.staging.donatty.com/en/llms.txt)