Skip to content

查询微信是否在线

接口地址: POST /isOnline

查询指定 wId 是否在线。适合发送消息前校验,或在后台展示实例状态。

说明

接口成功不等于实例在线。在线状态以 data.isOnline 为准。

请求参数

参数名必选类型说明
wIdstring登录实例标识

响应参数

参数名类型说明
codestring1000 接口调用成功,1001 接口调用失败
messagestring反馈信息
data.isOnlinebooleantrue 在线,false 离线

请求示例

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

在线响应

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

离线响应

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

错误响应

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

使用建议

  • 发送前主动检查,用本接口。
  • 实时感知掉线,接入消息回调。
  • 查询为离线时,可继续调用 查询掉线原因断线重连