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

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

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

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

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

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

## Чей ключ

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

## Права ключа

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

Тот же ключ подключает [MCP-сервер](/api/mcp/) для ИИ-ассистентов: ассистент тратит запросы так же, как ваш код.

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

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

!!! warning
    Не публикуйте ключ в коде на GitHub и в браузерных скриптах: им можно расходовать лимит вашей организации.