获取任务浏览器短期令牌

为本人已有运行任务的浏览器连接取得短期身份证明。调用不会创建替代环境或启动新浏览器。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/browser/token

调用前准备

准备当前产品身份和工作区ID。任务须属于当前用户、具有对话上下文,已准入沙箱工具且原浏览器可用;当前智能体使用权限仍有效。

请求参数

curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks/$TASK_ID/browser/token" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" --data '{}'

参数

类型

说明

workspace_id

string

本人任务所属工作区。

task_id

string

原运行任务ID。

产品身份请求头

string

示例使用当前环境个人访问令牌。

请求体

object

无业务字段;示例发送{}。

成功响应

{
  "code": 0,
  "data": {
    "token": "moi-browser-token-v1.example",
    "expires_at": "2026-11-12T04:01:00Z"
  }
}

字段或响应项

类型

说明

code

integer

成功为0。

data.token

string

短期不透明证明;作为WebSocket子协议传递,不写入URL。

data.expires_at

string

RFC3339到期时间。当前证明期限60秒,连接仍会重新授权。

Cache-Control

HTTP header

成功响应为no-store。

错误响应

HTTP / code

条件

400 / 2

浏览器参数无效。

401 / 6

身份证明无效,或流证明不匹配路径。

403 / 5

当前授权拒绝,或流的Origin/子协议不符合要求。

404 / 3

任务不可访问、非本人任务或缺少所需上下文。

409 / 15

现有浏览器未运行,details.reason=BROWSER_NOT_RUNNING。

410 / 3

原环境已结束或过期,details.reason=BROWSER_SESSION_ENDED。

503 / 15

浏览器运行依赖不可用,或任务状态不能使用。

500 / 1

其他内部失败。

101升级后不再返回普通HTTP JSON错误;周期复查失败可关闭连接,恢复见环境与错误。

产品认证阶段还可能使用字符串code/msg,不能将上表数字错误当作全部认证封套。

最后更新于