分页获取窗口浏览器列表

请求方法以及路径

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

接口功能描述

用于分页式获取窗口浏览器的列表 。

请求参数

Header 请求参数

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

Body 请求参数

参数名	是否必须	示例	默认值	类型	说明
page	是	2	1	number	1<=page<=200
per_page_count	是	2	10	string	1<=per_page_count<=200
key_sort	是	desc	asc	string	排序默认asc升序 [desc,asc]

请求参数示例

{
  "page": 2,
  "per_page_count": "2",
  "key_sort": "desc"
}

返回数据

成功响应示例

成功有数据例子

{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "success",
    "errorCode": "",
    "errorMsg": "",
    "result": {
      "current_page": 1,
      "per_page": "10",
      "total": 1,
      "total_pages": 1,
      "data": [
        {
          "key": 1,
          "windowName": "窗口-1",
          "browserSettingInfo": {
            "brand": "chrome",
            "version": "122.0.6261.95",
            "webRTC": "disabled"
          },
          "advancedSettingInfo": {
            "webRTC": "disabled",
            "platform": "Win32",
            "useragentMode": "strict",
            "useragent": null,
            "otherFingerprintItem": null
          },
          "fingerprintHash": "",
          "shouldChangeFingerprint": true,
          "changedKeyList": [],
          "ipProxy": {
            "settings": {
              "way": 1,
              "queryChannels": "IP-API",
              "type": "null",
              "agreement": "IPv4",
              "host": "",
              "port": "",
              "account": "",
              "password": ""
            },
            "ipInfo": {
              "country": "中国",
              "countryCode": "CN",
              "city": "深圳",
              "zip": "",
              "lat": 22.5559,
              "lon": 114.0577,
              "address": "116.30.231.167",
              "timezone": "Asia/Shanghai",
              "showReloadBtn": false
            }
          },
          "openWindowBtnStyle": {
            "canOpenWindowFlage": true,
            "canCloseWindowFlage": false,
            "btnStyleClass": "open-windows-btn-canOpen",
            "text": "打开",
            "loading": false,
            "textColor": "#fff"
          },
          "openUrlArray": "",
          "star": false,
          "windowFilterType": "self",
          "windowGroupKey": "Ungrouped",
          "windowBrowserPluginsKey": "default",
          "notes": "无",
          "createdAt": "2025/1/4 17:30:23",
          "lastOpenAt": "",
          "updatedAt": "2025/1/4 17:30:23",
          "checkChangeKeyList": [],
          "changeFingerprint": ""
        }
      ]
    }
  }
}

成功无数据例子

{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "success",
    "errorCode": "",
    "errorMsg": "",
    "result": {
      "current_page": 1,
      "per_page": "10",
      "total": 0,
      "total_pages": 0,
      "data": []
    }
  }
}

失败响应示例

调用接口失败

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

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

本次分页获取数据操作失败

{
  "code": "00000",
  "message": "Success",
  "data": {
    "status": "failed",
    "errorCode": "E01",
    "errorMsg": "page 必须是 1 ～ 200 之间的一个正整数 。",
    "result": {}
  }
}

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

错误码	错误原因
E00	参数(xxx)格式有误！
E01	page 必须是 1 ～ 200 之间的一个正整数 。
E02	per_page_count 必须是 1 ～ 200 之间的一个正整数 。
E03	key_sort 必须是 "desc"(降序排列) 或 "asc"(升序排列) 。