Ключи и авторизация

Каждый запрос к API подписывается ключом вида dtk_….

Как передать ключ

В заголовке Authorization:

Authorization: Bearer dtk_ваш_ключ

или в заголовке X-API-Key: dtk_ваш_ключ.

Чей ключ

Ключ принадлежит организации: её тариф, лимиты и закрытые каналы, которые она подтвердила. Ключей у организации столько, сколько даёт тариф: «Тест» — 1, «Старт» — 2, «Рост» — 5, «Профи» — 20.

Права ключа

При создании ключа на странице «API-ключи» можно поставить отметку «Чтение и запись». Без неё ключ только читает данные — этого хватает для всех методов, кроме управления вебхуками. Создавать, менять и удалять вебхуки может только ключ «чтение и запись»; ключ без отметки получит 403 read_only_key. Отметку потом не изменить — нужен другой ключ.

Тот же ключ подключает MCP-сервер для ИИ-ассистентов: ассистент тратит запросы так же, как ваш код.

Когда ключ перестаёт работать

• Ключ отозвали на странице «API-ключи».
• Участника отключили от организации — его ключи отзываются.
• Участник «на паузе» (не хватило мест по тарифу) или организация в архиве — ключи приостанавливаются и снова работают, когда доступ вернётся.