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

Запросите последние донаты канала из терминала macOS, Linux или Windows.

## 1. Выпустите секретный ключ

В блоке «Секретные ключи» нажмите «Выпустить секретный ключ». Задайте название, отметьте «Донаты» (`donations:read`), выберите срок и нажмите «Выпустить ключ». Скопируйте ключ сразу: мы показываем его один раз.

[Открыть раздел «Разработчикам»](https://streamer.donatty.com/developers)

## 2. Сохраните ключ в переменной

Вставьте свой ключ вместо `dnt_pat_...` и выполните команду в терминале.


**macOS и Linux:**

```sh
export DONATTY_TOKEN="dnt_pat_..."
```
**Windows (PowerShell):**

```powershell
$env:DONATTY_TOKEN = "dnt_pat_..."
```


Переменная действует, пока открыто окно терминала. В новом окне задайте её снова.

## 3. Запросите донаты

> **Отклонённые модерацией тоже приходят.**
> Без `moderation=PASSED,NONE` API отдаёт все донаты с полным текстом, включая отклонённые. Фильтры ваших виджетов к API не применяются.



**macOS и Linux:**


```sh
curl -s "https://api.donatty.com/v1/donations?limit=5&moderation=PASSED,NONE" \
  -H "Authorization: Bearer $DONATTY_TOKEN"
```

**Windows (PowerShell):**


```powershell
curl.exe -s "https://api.donatty.com/v1/donations?limit=5&moderation=PASSED,NONE" `
  -H "Authorization: Bearer $env:DONATTY_TOKEN"
```



```json
{
  "items": [
    {
      "id": "don_5d2e8f31-6a47-4c19-9b0e-7f3a2d1c8e46",
      "createdAt": "2026-11-09T10:21:47Z",
      "source": "DONATTY",
      "donorName": "Алексей",
      "message": "Спасибо за стрим!",
      "amount": {"value": "500.00", "currency": "RUB"},
      "feeCompensation": {"value": "27.00", "currency": "RUB"},
      "paymentMethod": "CARD",
      "goal": null,
      "moderation": {"status": "PASSED", "deadline": null},
      "media": null
    },
    {
      "id": "don_9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
      "createdAt": "2026-11-09T09:58:00Z",
      "source": "DONATION_ALERTS",
      "donorName": "Maria",
      "message": "Hi from Donation Alerts",
      "amount": {"value": "5.00", "currency": "USD"},
      "feeCompensation": null,
      "paymentMethod": null,
      "goal": null,
      "moderation": {"status": "NONE", "deadline": null},
      "media": null
    }
  ],
  "nextCursor": null
}
```

Пустой `items` — донатов, которые можно показать на стриме, пока нет.

`amount` — основная сумма доната. Если донатер доплатил за комиссию, доплата лежит в `feeCompensation` в той же валюте, иначе там `null`. Способ оплаты — в `paymentMethod`: `SBP` для СБП, `CARD` для остального, `null` у донатов Donation Alerts.

## Что показывать на стриме

| Статус | Что делать |
|---|---|
| `NONE` | показать: модерации не было |
| `PASSED` | показать: модерация пропустила |
| `PENDING` | перечитать после `moderation.deadline` |
| `BLOCKED` | не показывать |

## Дальше

- Бот целиком: [Node.js](https://developers.donatty.com/examples/bot-node.md) или [Python](https://developers.donatty.com/examples/bot-python.md). Перечитывает `PENDING`, ждёт после 429.
- [Параметры метода «Донаты»](https://developers.donatty.com/reference/donations.md)
- [Ошибки](https://developers.donatty.com/errors.md)
