Как управлять API-ключами

С помощью API-ключей можно обращаться к API Klang из своих скриптов и сервисов. Каждый ключ личный: он действует от вашего имени и дает доступ только к тому содержимому, к которому есть доступ у вас.

Как создать API-ключ

1. Откройте Настройки → Разработчикам → API
2. Нажмите Создать API-ключ
3. В поле Имя введите название, по которому будет понятно, где используется ключ (например, «CRM в продакшене»)

4. Нажмите Создать

Klang покажет значение нового ключа один раз.

Скопируйте ключ сейчас и сохраните его в надежном месте, например в менеджере паролей или в хранилище секретов вашей CI-системы. После закрытия этого окна полный ключ больше не показывается. Если вы его потеряли, отзовите ключ и создайте новый.

Как использовать ключ

Передавайте ключ как bearer-токен в заголовке Authorization:

curl https://app.klang.ai/api/v1/me \
  -H "Authorization: Bearer sk_..."

Полный справочник со всеми конечными точками и форматами запросов есть в документации по API.

Как управлять ключами

В каждой строке видно название ключа, короткий префикс (остальная часть скрыта), время последнего использования и дату создания. По столбцу Последнее использование удобно находить ключи, которые больше не нужны.

Чтобы отозвать ключ, нажмите значок корзины в его строке. Запросы с этим ключом сразу перестанут работать. Это действие нельзя отменить.

Личный доступ и доступ рабочего пространства

API-ключи наследуют ваш доступ. Если вы видите встречу или папку в Klang, ваш ключ может прочитать ее через API. Если вы покинете рабочее пространство или ваш доступ отзовут, ваши ключи тоже перестанут работать.