创建浏览器会话

请求参数

• projectIdstring可选

  可省略；账户使用 default 项目。

• keepAliveboolean可选
  默认 false

  false 时最后一个客户端断开且无人观看后结束会话；true 时保留至关闭或超时。

• timeoutnumber可选
  默认 3600

  从创建时刻起算的会话最长寿命，单位为秒；可含小数。

• browserSettingsobject可选

  创建浏览器时的登录态、视口及兼容选项；省略时不加载已保存的登录态。

  ▸ 展开子字段（13）

  • contextobject可选

    新会话使用的已保存登录态；必须属于当前账户；persist 为 true 时同一登录态只能有一个写入会话。

    ▸ 展开子字段（2）

    • idstring必填

      登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。

    • persistboolean可选
      默认 false

      关闭会话时合并保存 cookie 和 localStorage；false 只读取登录态；不保存 IndexedDB。

  • viewportobject可选

    浏览器视口尺寸；创建时省略整个对象则使用宽 1280、高 800 像素。

    ▸ 展开子字段（2）

    • widthinteger必填

      浏览器视口宽度，单位为像素，必须为正整数。

    • heightinteger必填

      浏览器视口高度，单位为像素，必须为正整数。

  • blockAdsboolean可选◐ 部分支持

    接受但忽略；不会启用此能力。

  • solveCaptchasboolean可选◐ 部分支持

    接受但忽略；不会启用此能力。

  • recordSessionboolean可选◐ 部分支持

    接受但忽略；不会启用此能力。

  • logSessionboolean可选◐ 部分支持

    接受但忽略；不会启用此能力。

  • extensionIdstring可选○ 未支持

    不支持此配置。

  • verifiedboolean可选○ 未支持

    不支持此配置。

  • advancedStealthboolean可选○ 未支持

    不支持此配置。

  • osstring可选○ 未支持

    不支持此配置。

  • fingerprintobject可选○ 未支持

    不支持此配置。

  • allowedDomainsarray可选○ 未支持

    不支持此配置。

  • ignoreCertificateErrorsboolean可选○ 未支持

    不支持此配置。

• proxiesunion可选◐ 部分支持

  仅省略、false 或 [{type: 'none'}] 可用，其它代理配置返回 501。

• regionstring可选◐ 部分支持

  接受但忽略；不会启用此能力。

• extensionIdstring可选○ 未支持

  不支持此配置。

• userMetadataobject可选

  自定义 JSON 元数据；序列化后的长度最多为 512 个 UTF-16 代码单元。

• namestring可选

  会话名称；1–128 个 ASCII 字母、数字或 . _ : -，可用于筛选会话。

• labelsobject可选

  自定义字符串标签；最多 32 项，键最多 128 个 UTF-8 字节，值最多 1024 个 UTF-8 字节。

返回

201

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