云端浏览器 API

列出登录态

分页列出当前账户保存的登录态，按登录态 ID 升序排列。每项返回名称、标签及保存内容的统计信息；将 nextCursor 原样传入读取下一页，直到其为 null。

GET /browser/v1/contexts● 支持

请求参数

cursorstring可选
上一页返回的 nextCursor，原样传入以继续读取；省略时读取第一页。
limitinteger可选
每页最多返回的登录态数量；默认 25，范围 1–100。

返回

200

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

连接与使用指南

响应

HTTP 200

请求成功。

application/json

名称	类型	说明
data	array<object>	本页查询匹配的记录；没有匹配项时为空数组。
data[].id	string	登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。
data[].projectId	string	兼容项目标识，当前账户的登录态固定返回 default。
data[].createdAt	string	登录态创建时刻，UTC ISO 8601 时间。
data[].updatedAt	string	登录态名称、标签或保存内容最近一次更新的时刻，UTC ISO 8601 时间。
data[].name	string	登录态名称；非空时为 1–128 个 ASCII 字母、数字或 . _ : -，在当前账户内唯一；空字符串表示不设名称或清除名称。
data[].labels	object	自定义字符串标签；最多 32 项，键最多 128 个 UTF-8 字节，值最多 1024 个 UTF-8 字节。
data[].sites	array<string>	已保存的 localStorage 主机名和 cookie 域名，去掉 cookie 域名前导点后去重排序。
data[].cookieCount	integer	登录态中已保存的 cookie 条目数量；新登录态为 0。
data[].bytes	integer	登录态加密后保存内容的大小，单位为 UTF-8 字节。
data[].lockedBy	string	当前登录态写入租约的持有者标识；无有效租约时省略。
data[].lastUsedAt	string
nextCursor	string \| null	下一页游标；原样传入 cursor，null 表示没有更多结果。

创建登录态

创建空的浏览器登录态，用于在会话之间保存 cookie 和 localStorage。将返回的 id 传入 browserSettings.context.id，并设置 persist=true 才会保存会话中的更新。

读取登录态

读取当前账户的指定登录态元数据、保存内容统计及写入租约持有者，不返回 cookie 或 localStorage 内容。contextId 使用创建或列表返回的 id；不存在或不属于当前账户时返回 404。