Перейти к содержимому

Ключи

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

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

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

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

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

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

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

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

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

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

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

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