打开窗口浏览器

请求方法以及路径

POST http://localhost:[端口号]/openapi/window/browser/open?ticket=[OpenApi票据]

接口功能描述

用于打开窗口浏览器。

请求参数

Header 请求参数

参数名	参数值	必填	类型	描述
Content-Type	application/json	是	String	application/json

Body 请求参数

参数名	是否必须	类型	说明
arrange_type	否	null || string	窗口排列方式：null: 使用渲染端的用户设置，default: 系统默认、stacking: 堆叠 、nineSquareGrid: 九宫格
display_screen_id	否	number	指定显示器 ID -1：表示使用渲染端用户设置
interval_time	否	number	批量打开窗口的时间间隔单位为毫秒，-1：表示使用渲染端用户设置
open_keys	是	object	打开窗口的信息对象配置项查看

参数详解

open_keys 配置参数对象键值详解

参数名	是否必须	类型	说明
window_browser_key	是	string	窗口浏览器的唯一标识，在 获取窗口列表 API可以查询到

请求参数示例

{
  "arrange_type": null,
  "display_screen_id": -1,
  "interval_time": -1,
  "open_keys": [
    {
      "window_browser_key": 1
    },
    {
      "window_browser_key": 2
    },
    {
      "window_browser_key": 3
    },
    {
      "window_browser_key": 113
    }
  ]
}

接口响应结果示例

成功响应示例

{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "success",
    "errorCode": "",
    "errorMsg": "",
    "result": {
      "openStatus": [
        {
          "type": "success",
          "reason": "成功",
          "windowBrowserKey": 1,
          "runInfo": {
            "ws": "ws://127.0.0.1:57702/devtools/browser/d300c470-bfd7-4686-8e1a-59eb593604f7",
            "debugging_port": "57702",
            "debugging_address": "127.0.0.1:57702",
            "pid": 61458,
            "webdriver": "/Users/zzt/Library/Application Support/ABC-fingerprint-browser/custom_storage/resource/app_browsers_bin/chrome/122.0.6261.95/chromedriver"
          }
        },
        {
          "type": "success",
          "reason": "成功",
          "windowBrowserKey": 2,
          "runInfo": {
            "ws": "ws://127.0.0.1:57712/devtools/browser/8de8427f-7a89-4d91-9aae-1cd5929eb7c9",
            "debugging_port": "57712",
            "debugging_address": "127.0.0.1:57712",
            "pid": 61474,
            "webdriver": "/Users/zzt/Library/Application Support/ABC-fingerprint-browser/custom_storage/resource/app_browsers_bin/chrome/122.0.6261.95/chromedriver"
          }
        }
      ],
      "arrangeType": "nineSquareGrid",
      "displayScreen": {
        "id": 1,
        "label": "内建视网膜显示器",
        "size": {
          "width": 1512,
          "height": 982
        },
        "workArea": {
          "x": 0,
          "y": 38,
          "width": 1512,
          "height": 859
        },
        "workAreaSize": {
          "width": 1512,
          "height": 859
        }
      },
      "intervalTime": 100
    }
  }
}

失败响应示例

调用接口失败

接口响应状态码，不为00000时，接口调用失败。
具体接口调用错误原因可查看接口响应状态码信息对照表进行查询。

{
  "code": "00001",
  "message": "产生未知错误，请反馈给官方客服！",
  "data": {}
}

本次修改操作失败

{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "failed",
    "errorCode": "E00",
    "errorMsg": "参数格式有误！ ｜  数组中有一项参数格式有误！",
    "result": {}
  }
}

操作失败 errorCode 错误码信息对照表

错误码	错误原因
E00	参数格式有误！ ｜ 数组中有一项参数格式有误！
E01	参数不能为空。
E02	数组中有一项缺少参数 xxx
E03	数组中有一项参数存在多余
E04	数组中有一项的 window_browser_key 必须满足：key 必须是 1 ～ 1000 之间的一个正整数
E029	一次性批量打开的窗口总个数不能超过：24 个, 如果您有特殊需求，请联系官方客服进行定制。
E030	打开状态的窗口总个数不能超过：48 个，如果您有特殊需求，请联系官方客服进行定制
E031	【(批量)打开窗口浏览器】时产生异常，请反馈给官方客服人员！