Аутентификация

Как выбрать токен и передать область бота или воркспейса.

Передавайте токен в каждом запросе:

Authorization: Bearer <token>

Тип токена зависит от задачи.

Токен	Область	Использование
PAT	Воркспейс пользователя	Admin API, каталог, деплой и управление ресурсами.
Bot API key	Один бот	Chat, Files и Tables API от имени бота.
Integration API key	Одна интеграция	Вызовы интеграции в разрешённой области.

Admin API обычно требует x-workspace-id. Bot-scoped операции требуют x-bot-id, если идентификатор не зафиксирован в токене.

curl https://botruntime.ru/v1/admin/bots \
  -H "Authorization: Bearer $PAT" \
  -H "x-workspace-id: $WORKSPACE_ID"

Не передавайте токены в query string. Не записывайте их в исходный код, логи и скриншоты. Для CLI храните PAT в профиле brt; для CI используйте секрет системы сборки.

Ответ 401 означает, что токен отсутствует или не прошёл проверку. Ответ 403 означает, что токен действителен, но не даёт доступ к выбранному ресурсу.