remo · документация
AI EN

Токены интеграций

Действовать без браузерной сессии: доступ владельца, сужённый scope, с обязательным сроком и отзывом.

Статус: доступно обновлено 2026-10-28

Что даёт

Токен позволяет интеграции читать комнату и выполнять команды без браузера. Он не создаёт новых прав: эффективное право — это доступ его владельца в комнате, пересечённый со scope токена.

Когда использовать

  • Скрипт или CI должен создать объекты в комнате.
  • Внешняя система читает содержимое комнаты по расписанию.
  • Вебхук-получатель хочет подтвердить изменение, прочитав комнату.

Как работает

Администратор организации выпускает токен: секрет вида remo_it_… показывается один раз, в базе остаётся только хеш. Запрос с заголовком Authorization: Bearer remo_it_… резолвится в владельца токена; сервер проверяет доступ владельца к комнате, а scope дополнительно сужает набор действий.

Что делает Нужно
POST /boards/:id/commands scope board.edit и board.edit у владельца
GET /boards/:id/widgets scope board.read и board.read у владельца

Пример

Вход: токен со scope board.read и комната, которую владелец видит. Действие: GET /boards/<id>/widgets с Authorization: Bearer …. Результат: 200 и объекты комнаты. Тот же токен на POST /commands получит 403 SCOPE_REQUIRED.

Что можно настроить

Метку, scopes (board.read, board.edit) и срок жизни: от 1 до 365 дней, по умолчанию 90. Бессрочного токена нет.

Ограничения

  • Токен не шире своего владельца: если у него отобрали доступ к комнате, токен теряет силу на следующем запросе.
  • Токен не может читать метаданные комнаты, экспортировать, управлять доступом и вызывать агентов — эти маршруты только для сессии.
  • Ключ идемпотентности действует в пространстве токена: два токена не переиграют команду друг друга.

Практические инструкции

Подключить интеграцию — выпуск токена и первая команда.

Связанные возможности

События и вебхук, доступ, команды.