# 获取任务浏览器短期令牌

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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

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

## 调用前准备

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

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
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 '{}'
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `workspace_id` | string | 本人任务所属工作区。 |
| `task_id` | string | 原运行任务ID。 |
| 产品身份请求头 | string | 示例使用当前环境个人访问令牌。 |
| 请求体 | object | 无业务字段；示例发送{}。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段或响应项 | 类型 | 说明 |
| --- | --- | --- |
| `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错误；周期复查失败可关闭连接，恢复见[环境与错误](errors-environments.md)。

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