获取指定用户在线状态

简要描述

• 获取指定用户各终端在线状态和token。

请求方式

• post

请求URL

• http://x.x.x.x:10002/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	错误详细信息