Публичное API

API-токен нужен серверной интеграции для запросов к Публичному API Noiro. Он привязан к вашему пользователю и организации. Передавайте ключ в заголовке Authorization: Bearer <token>.

Как открыть раздел

Нажмите на аватар в правом верхнем углу и выберите Публичное API.

Выбор имени и прав

В блоке Создать токен укажите понятное название интеграции. Оставьте выбранными только те scope, которые нужны её запросам. Например, для чтения процессов достаточно workflows:read. Для создания токена нужны название и хотя бы один scope. Если нужного scope нет, API вернёт статус 403.

Создание и сохранение ключа

Нажмите Создать токен, затем сразу скопируйте показанный ключ и сохраните его в защищённом хранилище интеграции. Полный ключ возвращается только при создании или перегенерации: в списке активных токенов остаются название, префикс, права и даты использования.

Не вставляйте API-токен в документацию, исходный код или сообщения.

Перегенерация токена

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

Сохранение ключа после перегенерации

Сразу скопируйте новый ключ и замените им старый ключ в защищённом хранилище интеграции. После ухода со страницы получить полное значение из списка активных токенов нельзя.

Отзыв токена

Если интеграции больше не нужен доступ, нажмите Отозвать у нужного токена и подтвердите действие. Доступ по этому ключу прекратится сразу, а токен исчезнет из списка активных.