动态设置代理 IP

为指定微信实例动态设置代理 IP。设置后，该微信实例后续网络请求会按服务端策略使用新的代理配置。

接口地址： POST /setproxy

前置条件

• 当前开发者账号具备操作该微信实例的权限。
• wcId 为已登录微信实例对应的微信 ID。
• 代理地址、账号和密码必须有效，并且代理服务可正常连通。

请求参数

参数名	必选	类型	说明
wcId	是	string	微信 ID
proxyIp	是	string	代理 IP 和端口，例如 121.229.46.245:3829
proxyUser	是	string	代理平台账号
proxyPassword	是	string	代理平台密码

请求示例

{
  "wcId": "wxid_ctqh94e1e722",
  "proxyIp": "121.229.46.245:3829",
  "proxyUser": "proxy_user",
  "proxyPassword": "proxy_password"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object / null	成功时通常返回 null

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": null
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 设置代理前先确认代理可用，避免微信实例因为代理不可达而掉线。
• 代理账号、密码属于敏感信息，不建议写入前端日志或公开配置。
• 如设置后实例异常，建议先查询在线状态和掉线原因，再决定是否重新设置代理。