Ключ открывает данные только вашего канала. В запросах и ответах API ключ называется токеном (token): отсюда коды ошибок вроде invalid_token. Выпустить ключ можно в кабинете, в разделе «Разработчикам».
| Секретный ключ | Публичный ключ | |
|---|---|---|
| Для чего | бот, сервер, скрипт | код страницы сайта |
| Что читает | то, что вы отметили в правах, включая донаты | профиль, цели и статистику; донаты не читает |
| Срок | 30, 90 или 365 дней | без срока |
| Значение | показываем один раз | можно скопировать снова |
Выпустите ключ
Заголовок раздела «Выпустите ключ»Секретный. В блоке «Секретные ключи» нажмите «Выпустить секретный ключ», задайте название, права и срок и нажмите «Выпустить ключ». Скопируйте значение сразу: потом его не посмотреть.
Публичный. В блоке «Публичный ключ» нажмите «Выпустить публичный ключ», укажите адрес сайта и нажмите «Выпустить ключ».
Открыть раздел «Разработчикам»Права секретного ключа
Заголовок раздела «Права секретного ключа»| В кабинете | Право | Что открывает |
|---|---|---|
| Профиль | profile:read |
ник, имя, аватар, ссылку на страницу доната |
| Донаты | donations:read |
донаты целиком, включая отклонённые модерацией |
| Цели | goals:read |
цели и собранные суммы |
| Статистика | stats:read |
топ донатеров и сумму за период |
Отметьте только нужные: права выпущенного ключа не меняются.
Храните секретный ключ на сервере
Заголовок раздела «Храните секретный ключ на сервере»Держите его в переменной окружения или в настройках бота. Не вставляйте его в код сайта, репозиторий, чат или OBS: с ним любой прочитает ваши данные.
Публичный ключ можно держать в коде сайта. Он работает только с адресов, которые указаны в его настройках.
Замените секретный ключ
Заголовок раздела «Замените секретный ключ»Срок не продлевается. Чтобы бот не остался без доступа:
- Выпустите новый ключ.
- Подключите его и проверьте запрос.
- Удалите старый. Удаление срабатывает в течение минуты.
Если ключ попал в чужие руки, выпустите новый и сразу удалите старый.
Сколько ключей можно выпустить
Заголовок раздела «Сколько ключей можно выпустить»До 20 действующих, включая публичный. Истёкшие в лимит не входят и остаются в списке с пометкой «Истёк», пока вы их не удалите.