获取任务浏览器短期令牌¶
为本人已有运行任务的浏览器连接取得短期身份证明。调用不会创建替代环境或启动新浏览器。
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 '{}'
参数 |
类型 |
说明 |
|---|---|---|
|
string |
本人任务所属工作区。 |
|
string |
原运行任务ID。 |
产品身份请求头 |
string |
示例使用当前环境个人访问令牌。 |
请求体 |
object |
无业务字段;示例发送{}。 |
成功响应¶
{
"code": 0,
"data": {
"token": "moi-browser-token-v1.example",
"expires_at": "2026-11-12T04:01:00Z"
}
}
字段或响应项 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为0。 |
|
string |
短期不透明证明;作为WebSocket子协议传递,不写入URL。 |
|
string |
RFC3339到期时间。当前证明期限60秒,连接仍会重新授权。 |
|
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,不能将上表数字错误当作全部认证封套。
最后更新于