修改代理信息

API 参考

修改代理信息

Request

更新一条代理配置。

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

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

Security

Authorization

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

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

curl -i -X POST \
  https://api.morelogin.com/proxyInfo/update \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -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"
}