查询最近的登录记录

需要scope：ZMS.Users.Statistics

每个用户只有一条最新的登录记录

接口时间均为世界标准时

筛选条件filter说明

格式：object对象的encodeURIComponent字符串

不同条件之间为与关系，无相应字段则表示不筛选该条件

array类型中各元素间为或关系

支持的字段
| 字段名称 | 类型 | 说明 |
| --- | --- | --- |
| userGuids | array[string] | 用户GUID |
| before | string | 在此时间(含)之前的登录记录 |
| after | string | 在此时间(含)之后的登录记录 |
| clients | array[string] | 登录的客户端ID |
| deviceTypes | array[string] | 登录的设备类型 |
| platforms | array[string] | 系统平台 |

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

pageSize

string

可选

每页数量，1~1000，默认50

示例值:

pageNum

string

可选

由1开始的页码，默认1

示例值:

sortOrder

string

可选

排序方式，按时间排序：asc(升序)；decs(降序，默认)

示例值:

decs

filter

string

筛选条件

可选

Header 参数

Authorization

string

必需

返回响应

🟢200成功

application/json

Body

status

integer

返回码

必需

详情请查看全局返回码

message

string

错误详细信息

必需

无错误时，返回：success

error

string | null

错误代号

必需

详情请查看全局返回码

totalNum

number

总数量

必需

pageSize

number

每页数量

必需

pageNum

number

当前页码

必需

data

array [object {8}]

返回数据

必需

无数据时为空列表

guid

string

登录记录Guid

必需

userGuid

string

用户Guid

必需

loginTime

string

登录时间

必需

clientId

string

客户端ID

必需

deviceName

string

设备名称

必需

deviceType

string

设备类型

必需

platform

string

系统平台

必需

ipInfo

object

登录IP信息

必需

示例

{
    "status": 0,
    "message": "success",
    "error": null,
    "totalNum": 1,
    "pageSize": 50,
    "pageNum": 1,
    "data": [
        {
            "guid": "cb337956-3b15-4477-84b0-bd51a8ba7c2c",
            "userGuid": "4e881b7a-d736-4b5f-99e9-5102b9fd132a",
            "loginTime": "2022-10-09T07:04:03",
            "clientId": "CloudCAD_2D_Web",
            "ipInfo": {
                "ipAddress": "119.97.241.218",
                "country": "中国",
                "province": "湖北省",
                "city": "武汉"
            },
            "deviceType": "Desktop",
            "deviceName": "Chrome",
            "platform": "Windows"
        }
    ]
}

查询最近的登录记录

请求参数

示例代码

返回响应