Skip to content

断线重连微信实例

接口地址: POST /reconnectWx

手机端微信在线,但平台显示离线时,调用本接口尝试恢复连接。

网络波动、代理 IP 不稳定导致下线时,也可以先调用本接口。仍未恢复时,再走老设备扫码登录。

使用场景

适合处理“手机在线、平台离线”的短暂连接异常。它不是登录接口,不能替代老设备扫码登录。

前置条件

  • 当前请求已携带有效 Authorization
  • 已保存需要恢复的微信 ID(wcId)。
  • 如使用代理 IP,先确认代理网络可用。

请求参数

参数名必选类型说明
wcIdstring需要重新连接的微信 ID

请求示例

json
{
  "wcId": "wxid_mdf1ha1xqpvs12"
}

响应参数

参数名类型说明
codestring1000 成功,1001 失败
messagestring反馈信息
dataobject / null返回数据,具体以接口实际响应为准

成功响应

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

错误响应

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

使用建议

按以下顺序处理离线:

  1. 先调用 查询微信是否在线 确认平台侧状态。
  2. 手机在线、平台离线时,调用本接口恢复。
  3. 网络或代理不稳定时,先修复网络或代理,再调用本接口。
  4. 仍未恢复时,重新走老设备扫码登录。

注意

不要在短时间内频繁重复调用本接口。若多次重连失败,应优先检查网络、代理 IP、微信实例状态和登录环境。