关闭浏览器会话

关闭指定浏览器会话，返回关闭后的会话对象。请求体为 {"status":"REQUEST_RELEASE"}；若返回 409 SESSION_INVALID_STATE，可再次读取会话确认状态；已结束的会话可重复请求关闭。

POST /browser/v1/sessions/{sessionId}● 支持

请求参数

sessionIdstring必填
浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。
statusstring必填
会话操作指令；REQUEST_RELEASE 表示请求关闭浏览器并结束会话。
取值 REQUEST_RELEASE

200

错误含 statusCode、error、message；自有面另含 code。请求 ID 见 X-Request-Id。错误

连接与使用指南

响应

HTTP 200

请求成功。

application/json

名称	类型	说明
id	string	浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。
projectId	string	兼容项目标识，当前账户的会话固定返回 default。
status	string	会话生命周期状态；释放中的会话仍显示 RUNNING，但已不能建立新连接。
keepAlive	boolean	API 创建的会话是否在客户端断开后保留；true 不因空闲释放，仍受最长寿命限制。
region	string	兼容字段，不代表可选择部署区域。
proxyBytes	integer	兼容的代理流量字节数；当前未使用代理，固定返回 0。
createdAt	string	会话创建时刻，UTC ISO 8601 时间。
updatedAt	string	会话状态最近一次更新的时刻，UTC ISO 8601 时间。
startedAt	string	浏览器开始运行的时刻；尚未开始运行时返回创建时刻，UTC ISO 8601 时间。
expiresAt	string	会话最长寿命的到期时刻，等于创建时刻加 timeout 秒，UTC ISO 8601 时间。
endedAt	string	浏览器使用区间的结束时刻，UTC ISO 8601 时间；尚未记录结束时刻时省略。
contextId	string	登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。
userMetadata	object	创建会话时传入的自定义 JSON 元数据；未设置时为空对象。
name	string	会话名称；1–128 个 ASCII 字母、数字或 . _ : -，可用于筛选会话。
labels	object	自定义字符串标签；最多 32 项，键最多 128 个 UTF-8 字节，值最多 1024 个 UTF-8 字节。
origin	string	会话创建入口；api 为 API 创建，connect 为一步连接创建，console 为 Console 创建。
closeReason	string	会话释放原因；未开始释放时省略。
viewport	object	浏览器视口尺寸；创建时省略整个对象则使用宽 1280、高 800 像素。
viewport.width	integer	浏览器视口宽度，单位为像素，必须为正整数。
viewport.height	integer	浏览器视口高度，单位为像素，必须为正整数。
billedSeconds	number	会话计费时长，单位为秒；运行时随时长增长，结束后为最终计费时长，可含小数。
currentUrl	string	最近观察到的页面导航地址；尚未观察到导航时省略。
clients	integer	当前连接的 CDP 客户端数量；不包含仅观看页面的用户。
handoff	object \| null	待完成的人工接管请求；没有请求、已完成或已过期时为 null。
handoff.message	string	请求人工接管时提供给操作者的说明文字。
handoff.requestedAt	string	人工接管请求的发起时刻，UTC ISO 8601 时间。
handoff.expiresAt	string	人工接管请求的失效时刻，UTC ISO 8601 时间。