断线重连微信实例

接口地址： POST /reconnectWx

当手机端微信显示在线，但平台显示该微信实例离线时，可以调用本接口尝试重新连接微信实例。

如果因为网络波动、代理 IP 不稳定等原因导致微信实例下线，也可以先调用本接口恢复连接；如未恢复成功，再按老设备扫码登录流程重新登录。

使用场景

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

前置条件

• 当前请求已携带有效 Authorization。
• 已保存需要恢复的微信 ID（wcId）。
• 若该微信实例使用代理 IP，请先确认代理网络可用。

请求参数

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

请求示例

{
  "wcId": "wxid_mdf1ha1xqpvs12"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object / null	返回数据，具体以接口实际响应为准

成功响应

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

错误响应

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

使用建议

建议按以下顺序处理离线问题：

1. 先调用 查询微信是否在线 确认平台侧状态。
2. 如果手机端微信在线，但平台显示离线，调用本接口尝试恢复。
3. 如果是网络或代理 IP 不稳定导致下线，先修复网络或代理，再调用本接口。
4. 如果调用后仍未恢复成功，再重新走老设备扫码登录流程。

注意

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