查询掉线原因

查询指定微信实例的离线原因。若返回的 reason 为 null，表示当前实例在线。

接口地址： POST /offlineReason

前置条件

• 当前开发者账号具备查询该微信实例的权限。
• 已知要查询的微信实例 wcId。

请求参数

参数名	必选	类型	说明
wcId	是	string	微信 ID

请求示例

{
  "wcId": "wxid_ctqh94e1he722"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array	查询结果列表
data[].wcId	string	微信 ID
data[].reason	string / null	掉线原因；null 表示在线

成功响应

{
  "code": "1000",
  "message": "获取离线原因成功",
  "data": [
    {
      "wcId": "wxid_ctqh94e1he722",
      "reason": null
    }
  ]
}

错误响应

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

使用建议

• 排查掉线、重连失败或代理异常时，优先调用本接口确认原因。
• reason=null 不代表业务操作一定成功，只表示当前实例在线。
• 若返回明确掉线原因，建议先按原因处理，再执行重连或重新登录。