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

Авторизация

Для работы с Console API вы передаёте Bearer-токен (JWT) в заголовке Authorization при каждом запросе.

Базовый URL Console API: https://{client-host-prefix-short}-conf.trisigma.io/api/console

Значение {client-host-prefix-short} предоставляет менеджер Trisigma.

Управление токенами​

Токены вы создаёте и отзываете в веб-интерфейсе Trisigma: Настройки воркспейса → Соединения → API Tokens.

API Tokens

Токен Console API - персональный, с обязательным сроком действия. Отозвать (деактивировать) токен можно досрочно, восстановить отозванный токен нельзя.

Права доступа (Scopes)​

При выпуске токена вы выбираете набор прав (scopes). Каждое право открывает свою группу методов.

ПравоЧто разрешает
readЧтение экспериментов, конфигураций сегментации и справочников (GET-методы).
createСоздание экспериментов (POST /experiments/v1).
updateРедактирование экспериментов (PATCH /experiments/v1/{id}).
manageУправление жизненным циклом: запуск, остановка, архивация, разархивация.

Выпуск токена​

  1. В платформе Trisigma перейдите в раздел API Tokens.
  2. Нажмите Создать токен.
  3. Укажите понятное название, выберите права и срок действия.
  4. Скопируйте полученное значение.

Форма создания токена

Скопировать созданный токен

предупреждение

Токен отображается только один раз. После закрытия окна его значение недоступно.

Передавайте токен в заголовке каждого запроса к Console API:

Authorization: Bearer <ваш-токен>
Ошибки авторизации
  • 403 Forbidden с текстом Invalid api key provided - токен истёк, отозван или недействителен.
  • 401 Unauthorized - в запросе нет заголовка Authorization.