查询微信是否在线

接口地址： POST /isOnline

查询指定 wId 对应的微信实例是否在线。适合发送消息前校验实例状态，或在后台页面展示当前在线状态。

说明

接口调用成功不等于微信实例在线。请以响应中的 data.isOnline 判断在线状态。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识

响应参数

参数名	类型	说明
code	string	1000 接口调用成功，1001 接口调用失败
message	string	反馈信息
data.isOnline	boolean	true 在线，false 离线

请求示例

{
 "wId": "0000016e-abcd-0ea8-0002-d8c2dfdb0bf3"
}

在线响应

{
 "message": "成功",
 "code": "1000",
 "data": {
 "isOnline": true
 }
}

离线响应

{
 "message": "成功",
 "code": "1000",
 "data": {
 "isOnline": false
 }
}

错误响应

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

使用建议

如需实时感知下线事件，建议同时接入消息回调。在线查询适合主动检查，回调适合被动接收状态变化。