Что даёт
Токен позволяет интеграции читать доску и выполнять команды без браузера. Он не создаёт новых прав: эффективное право — это доступ его владельца на доске, пересечённый со 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. Бессрочного токена нет.
Ограничения
- Токен не шире своего владельца: если у него отобрали доступ к доске, токен теряет силу на следующем запросе.
- Токен не может читать метаданные доски, экспортировать, управлять доступом и вызывать агентов — эти маршруты только для сессии.
- Ключ идемпотентности действует в пространстве токена: два токена не переиграют команду друг друга.
Практические инструкции
Подключить интеграцию — выпуск токена и первая команда.
Связанные возможности
События и вебхук, доступ, команды.