查询账号在线状态

POST

http://manager.wecomapi.com/wecom/finder/api

接口提示

查询指定设备当前账号是否在线，以及账号基础状态信息。

建议在联系人、消息、外部群、文件等业务接口调用前，先确认账号处于可用在线状态。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

请求成功时返回统一响应结构，具体字段以 data 内容为准。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'http://manager.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/login/checkLogin",
  "params": {
    "guid": ""
  }
}'

响应示例

{
  "code": 200,
  "data": {
    "errorCode": 0,
    "errorMsg": "WFKPL49J1A==",
    "userId": "16888500000001",
    "lastActiveTime": 0,
    "userOnlineStatus": 2,
    "corpLogo": "",
    "corpName": "",
    "nickname": "张三"
  },
  "msg": "成功"
}

修改于 2026-07-03 10:03:16