Випуск, ротація та відкликання API-ключів

Випустіть ключ для сервісу, виберіть, що йому можна, замініть його секрет і відкличте його на сторінці ключів консолі.

4 хв читання

API-ключ дозволяє сервісу звертатися до Slen від імені одного проєкту. Ця сторінка — про сторінку ключів у консолі. Як запит використовує ключ, описано в статті Автентифікація.

Де розташовані ключі

Відкрийте Налаштування, потім Ключі та доступ. Сторінка показує ключі проєкту, вибраного в шапці. Виберіть там інший проєкт — і список зміниться разом із ним.

Ключ у списку показує свою назву, останні чотири символи секрету, час останнього використання, того, хто його створив, і кількість дозволів. Час останнього використання зберігається з точністю до хвилини.

Сторінка відкривається тому, хто має дозвіл management:read. Для випуску, ротації та відкликання потрібен management:write. Без нього сторінка — це список без кнопок.

Випустити ключ

1. Почніть створювати ключ

Натисніть Новий ключ.

2. Назвіть ключ

Дайте ключу назву сервісу, який ним користуватиметься. За назвою ключі відрізняють один від одного у списку. Вона може бути завдовжки до 120 символів.

3. Виберіть дозволи

Позначте, що ключу можна робити. Хоча б один дозвіл має бути позначений. У нового ключа одразу позначено Читання і Запуск операцій — цього досить, щоб надсилати запити й читати, що з них вийшло.

Дозвіл	Код	Що він дає ключу
Читання	`read`	Читати операції, виконання, реєстр і каталог моделей
Запуск операцій	`gateway:write`	Запускати флоу
Читання налаштувань	`management:read`	Читати флоу, підключення, пули та клієнтів
Зміна налаштувань	`management:write`	Змінювати їх і бюджети
Клієнти: читання	`customers:read`	Читати клієнтів, їхні рахунки й виписки, а також ціни в кредитах
Клієнти: поповнення, списання, блокування	`customers:write`	Створювати, поповнювати, списувати, коригувати, блокувати й видаляти клієнтів

Що включає кожен дозвіл, сказано в статті Автентифікація. Дозвіл flows:write на цій сторінці не має власної позначки, бо його включає Зміна налаштувань. Давайте ключу лише те, що потрібно його сервісу.

4. Створіть ключ і скопіюйте його

Натисніть Створити ключ. Ключ починається з sl_live_ і показується один раз. Скопіюйте його й покладіть туди, звідки сервіс читає свої секрети.

Slen зберігає лише хеш ключа. Після закриття вікна ключ більше не показати. Якщо його втрачено, виконайте ротацію.

Перевірити ключ

Надішліть запит із новим ключем. Цьому запиту потрібен дозвіл Читання.

Terminal

curl https://api.slen.ai/api/v1/models \
  -H "Authorization: Bearer $SLEN_API_KEY"

200 OK

{
  "data": [
    {
      "model_code": "gpt-4o-mini",
      "provider": "openai",
      "model_price_id": "1108",
      "input_price_per_million": "0.15000000",
      "output_price_per_million": "0.60000000",
      "cached_input_price_per_million": "0.07500000",
      "max_output_tokens": 16384,
      "currency": "USD",
      "effective_from": "2026-01-01T00:00:00+00:00",
      "effective_to": null
    }
  ]
}

Відповідь 401 з кодом invalid_api_key означає, що ключ скопійовано неправильно. Відповідь 403 з кодом insufficient_scope означає, що ключ працює, але дозволу не має.

Ротація ключа

Ротація замінює секрет ключа і зберігає сам ключ — з його назвою та дозволами. Відкрийте меню в рядку ключа, виберіть Ротація і підтвердьте. Новий секрет показується один раз, як секрет нового ключа.

Старий секрет перестає працювати одразу, і кожен сервіс, який досі його надсилає, отримує 401. Підготуйте розгортання нового секрету до ротації.

Відкликати ключ

Відкрийте меню в рядку ключа, виберіть Відкликати і підтвердьте. Ключ перестає працювати одразу, і відновити його не можна. Він переходить до списку відкликаних ключів унизу сторінки, з часом відкликання.

Ключ не має терміну дії. Він працює, доки його не відкликали.

Змінити те, що можна ключу

Дозволи ключа вибирають під час випуску й потім не редагують. Щоб дати сервісу більше або менше, зробіть три кроки.

Випустіть новий ключ із дозволами, які потрібні сервісу.
Перемкніть сервіс на новий ключ.
Відкличте старий ключ.

Ключ застосунку

Застосунку, який запускає флоу для своїх клієнтів і веде їхні кредити, потрібен ключ із двома дозволами: Запуск операцій і Клієнти: поповнення, списання, блокування. Такий ключ запускає флоу й веде клієнтів свого проєкту: додає, поповнює, коригує, блокує та видаляє їх і списує з них кредити. Він читає й клієнтів, їхні виписки та ціни в кредитах, бо Клієнти: поповнення, списання, блокування включає Клієнти: читання. Він не змінює ні флоу, ні бюджетів, ні цін у кредитах, ні ключів: для цього потрібна Зміна налаштувань.

Ключ із дозволом Зміна налаштувань теж веде клієнтів, бо цей дозвіл включає обидва дозволи клієнтів. Що потрібно кожній операції клієнтів, перелічує стаття Клієнти та кредити.

Ключі та проєкти

Ключ належить проєкту, у якому його випущено, і діє лише в цьому проєкті. Сервісу, який працює з двома проєктами, потрібен ключ кожного з них. Що доступно ключу, сказано в статті Автентифікація.