获取指定用户在线状态
简要描述
- 获取指定用户各终端在线状态和 token。
请求方式
post
请求 URL
{API_ADDRESS}/user/get_users_online_status
Header
header 名 | 示例值 | 选填 | 类型 | 说明 |
---|---|---|---|---|
operationID | 1646445464564 | 必填 | string | operationID 用于全局链路追踪 |
token | eyJhbxxxx3Xs | 必填 | string | 管理员 token |
请求参数示例
{
"userIDs": ["2890713225"]
}
字段名 | 选填 | 类型 | 说明 |
---|---|---|---|
userIDs | 必填 | array | 需要查询的用户 ID 列表 |
成功返回示例
{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": [
{
"userID": "2890713225",
"status": "online",
"detailPlatformStatus": [
{
"platform": "Windows",
"status": "online",
"connID": "bbb7c4da159b1ec6beb81c9e4129b075",
"isBackground": false,
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySUQiOiIyODkwNzEzMjI1IiwiUGxhdGZvcm1JRCI6MywiZXhwIjoxNzA0Njk1NzI0LCJuYmYiOjE2OTY5MTk0MjQsImlhdCI6MTY5NjkxOTcyNH0.-TBNT0YKn_8YH9oO8A8SYEpNzOg1-EQD8O23R0MsVLE"
},
{
"platform": "Android",
"status": "online",
"connID": "f18b67b5f57f01604b9f7c338238f43d",
"isBackground": false,
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySUQiOiIyODkwNzEzMjI1IiwiUGxhdGZvcm1JRCI6MiwiZXhwIjoxNzA0NTA5ODg4LCJuYmYiOjE2OTY3MzM1ODgsImlhdCI6MTY5NjczMzg4OH0.uii4Sf05z7VIGCDXUEtqq7cwdXakWkJJrCwYUigvc3I"
}
]
}
]
}
成功返回示例的参数说明
参数名 | 类型 | 说明 |
---|---|---|
errCode | int | 错误码,0 表示成功 |
errMsg | string | 错误简要信息,无错误时为空 |
errDlt | errDlt | 错误详细信息,无错误时为空 |
data | object | 通用数据对象,具体结构见下方 |
userID | string | 用户 ID |
status | string | 在线状态,在线:online,离线:offline |
detailPlatformStatus | array | 详细的各个平台的在线情况 |
detailPlatformStatus.platform | string | 平台 ID, 1:IOS,2:Android,3:Windows,4:OSX,5:Web,6:MiniWeb,7:Linux,8:Android Pad,9:IPad,10:admin |
detailPlatformStatus.status | string | 在线状态,在线:online,离线:offline |
detailPlatformStatus.connID | string | 连接 ID |
detailPlatformStatus.isBackground | boolean | app 是否处于后台 |
detailPlatformStatus.token | string | token 信息 |
失败返回示例
{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}
失败返回示例的参数说明
参数名 | 类型 | 说明 |
---|---|---|
errCode | int | 错误码,具体查看全局错误码文档 |
errMsg | string | 错误简要信息 |
errDlt | errDlt | 错误详细信息 |