# Ключи

Ключ открывает данные только вашего канала. В запросах и ответах API ключ называется токеном (token): отсюда коды ошибок вроде `invalid_token`. Выпустить ключ можно в кабинете, в разделе «Разработчикам».

| | Секретный ключ | Публичный ключ |
|---|---|---|
| Для чего | бот, сервер, скрипт | код страницы сайта |
| Что читает | то, что вы отметили в правах, включая донаты | профиль, цели и статистику; донаты не читает |
| Срок | 30, 90 или 365 дней | без срока |
| Значение | показываем один раз | можно скопировать снова |

## Выпустите ключ

**Секретный.** В блоке «Секретные ключи» нажмите «Выпустить секретный ключ», задайте название, права и срок и нажмите «Выпустить ключ». Скопируйте значение сразу: потом его не посмотреть.

**Публичный.** В блоке «Публичный ключ» нажмите «Выпустить публичный ключ», укажите адрес сайта и нажмите «Выпустить ключ».

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

## Права секретного ключа

| В кабинете | Право | Что открывает |
|---|---|---|
| Профиль | `profile:read` | ник, имя, аватар, ссылку на страницу доната |
| Донаты | `donations:read` | донаты целиком, включая отклонённые модерацией |
| Цели | `goals:read` | цели и собранные суммы |
| Статистика | `stats:read` | топ донатеров и сумму за период |

Отметьте только нужные: права выпущенного ключа не меняются.

## Храните секретный ключ на сервере

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

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

## Замените секретный ключ

Срок не продлевается. Чтобы бот не остался без доступа:

1. Выпустите новый ключ.
2. Подключите его и проверьте запрос.
3. Удалите старый. Удаление срабатывает в течение минуты.

Если ключ попал в чужие руки, выпустите новый и сразу удалите старый.

## Сколько ключей можно выпустить

До 20 действующих, включая публичный. Истёкшие в лимит не входят и остаются в списке с пометкой «Истёк», пока вы их не удалите.
