跳转到内容

批量修改浏览器环境代理

Request

为多个浏览器绑定代理。

  • 前置条件:envIds 与 uniqueIds 至少提供一个。传入的 proxyId 必须已存在于团队中,否则调用被拒绝而不是自动创建。
  • 副作用:在每个浏览器上写入 proxyId。默认情况下,当 proxyId 省略或为 0 时,会复用连接信息完全相同的已有代理;若没有匹配项,则在调用方团队中新建一条代理记录。
  • 完成信号:同步。运行中的浏览器仍使用启动时的代理。
  • 重试:重新绑定同一个 proxyId 是幂等的;但如果请求里带的是原始连接信息,每次去重未命中都可能再新建一条代理记录。

已记录的业务错误码:19106, 19193, 14023。 各错误码的含义见 Error Codes。任何接口还可能返回通用错误码。

Bodyapplication/jsonrequired
envIdsArray of strings

选择一个带有序列号的,必须填写一个。

proxyobjectrequired

用于更改环境绑定的代理。如果提供了 proxyId,则绑定到该 ID 所代表的代理;否则,绑定到新添加的代理。如果代理信息保持不变,则不会重新绑定(proxyIp、proxyPort、proxyType 或 proxyProvider 的任何更改都被视为新的代理,并且重新绑定成功)。

uniqueIdsArray of strings

选择一个带有环境 ID 的环境,必须填写一个。

curl -i -X POST \
  http://127.0.0.1:40000/api/env/setProxy/batch \
  -H 'Content-Type: application/json' \
  -d '{
    "proxy": {
      "city": "string",
      "country": "string",
      "encryptionType": 1,
      "ipChangeAction": 1,
      "ipMonitor": true,
      "password": "string",
      "proxyId": "1661515884160372",
      "proxyIp": "string",
      "proxyName": "example-name",
      "proxyPort": 1,
      "proxyProvider": "string",
      "proxyType": 1,
      "refreshUrl": "https://example.com/resource",
      "state": "string",
      "username": "example-name"
    }
  }'

Responses

成功。data 是单个布尔值。

Headers
any
Bodyapplication/json
codeinteger
msgstring or null
databoolean
requestIdstringrequired
Response
{ "code": 0, "msg": null, "data": true, "requestId": "d57cfecfc6904fcaa57da9f65b2a15fd" }