修改代理信息

API 参考

修改代理信息

Request

更新一条代理配置。

前置条件：代理必须存在于团队中。动态代理不能通过本接口更新。 供应商必须是已识别的取值。
副作用：这是整体覆盖而非局部更新——你省略的字段会回落到默认值，而不是保留当前值。请先读出该代理再完整回传。
生效范围：浏览器的绑定关系保持不变（因为只有代理记录本身发生变化），但已在运行的浏览器或云手机会继续使用它们启动时的连接信息。请重启它们以采用新配置。
完成信号：同步。没有乐观锁，并发更新是后写覆盖。

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

Bodyapplication/jsonrequired

idstringrequired

唯一代理 ID

proxyIpstringrequired

代理服务器 IP 地址

proxyPortintegerrequired

代理服务器端口

proxyNamestring

代理的自定义名称

countrystring

国家/地区（例如，“US”、“CN”）

citystring

城市名称

usernamestring

身份验证用户名（如果需要）

passwordstring

身份验证密码（如果需要）

proxyTypeinteger

代理协议类型：

0 = HTTP
1 = HTTPS
2 = SOCKS5
3 = SSH

proxyProviderintegerrequired

代理提供商 ID：

0 = HTTP
1 = HTTPS
2 = SOCKS5
3 = SSH
4 = Oxylabs
5 = Proxys.io
6 = GeoSurf
7 = Luminati
8 = Lumauto
9 = Oxylabsauto
10 = Trojan
11 = Shadowsocks
12 = vmess
13 = ABCPROXY
14 = LunaProxy
15 = IPHTML
16 = PiaProxy
17 = 922S5

encryptionTypeinteger

加密类型（提供商特定，通常为 0 表示明文）

ipMonitorboolean

启用 IP 地址变更监控

ipChangeActioninteger

IP地址变更时的操作：

1 = 通知/刷新（常用值）

查看系统文档了解完整选项。

refreshUrlstring

用于触发 IP 地址刷新的 URL（如果服务提供商支持）

statestring

保留字段或自定义状态（可选）

POST

/api/proxyInfo/update

curl -i -X POST \
  http://127.0.0.1:40000/api/proxyInfo/update \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1566403036579198",
    "proxyIp": "108.11.23.85",
    "proxyPort": 4096,
    "proxyName": "MyProxy",
    "country": "US",
    "city": "New York",
    "username": "",
    "password": "",
    "proxyType": 0,
    "proxyProvider": 0,
    "encryptionType": 0,
    "ipMonitor": true,
    "ipChangeAction": 1,
    "refreshUrl": "",
    "state": ""
  }'

Responses

成功。该接口不返回响应载荷，结果由 code 表达。

Headers

any

Bodyapplication/json

codeintegerrequired

返回结果代码 0：正常；其他代码均为例外情况。

msgstring or nullrequired

错误信息

requestIdstringrequired

操作请求 ID

Response

{
  "code": 0,
  "msg": "",
  "requestId": "efgh5678"
}