获取开门记录

更新时间：2024-08-19 06:22:52下载pdf

本文介绍获取开门记录的 API。

接口描述

获取门锁的开门记录。

接口地址

GET: /v1.0/devices/{device_id}/door-lock/open-logs

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID
page_no	Integer	query	true	页号
page_size	Integer	query	true	分页大小
start_time	Long	query	true	开始时间
end_time	Long	query	true	结束时间

返回参数

参数名	类型	说明
result	DoorLockHistoryRes

result 说明

参数名	类型	说明
total	Long	记录数量
logs	List	开门记录列表

logs 说明

参数名	类型	说明
update_time	Long	状态变更时间
status	BaseItemDTO	门锁状态列表

status 说明

参数名	类型	说明
code	String	状态码 unlock_fingerprint : 指纹解锁，门锁本地分配的编号 unlock_password : 密码解锁，门锁本地分配的编号 unlock_temporary : 临时密码解锁，值为密码 ID unlock_dynamic : 动态密码解锁，值为密码 ID unlock_card : 卡片解锁，门锁本地分配的编号 unlock_face : 人脸解锁，门锁本地分配的编号 unlock_key : 机械钥匙解锁，门锁本地分配的编号 unlock_identity_card : 身份证解锁，门锁本地分配的编号 unlock_emergency : 应急密码解锁，门锁本地分配的编号
value	Object	状态值

请求示例

GET: /v1.0/devices/vdevo15345926009****/door-lock/open-logs?page_no=1&page_size=20&start_time=1543213146&end_time=1543213546

返回示例

{
    "result": {
        "total": 1,
        "logs": [
            {
                "unlock_name": "",
                "update_time": 1612098422000,
                "user_id": "0",
                "nick_name": "",
                "status": {
                    "code": "unlock_finger",
                    "value": "123456"
                }
            }
        ]
    },
    "t": 1542626129429,
    "success": true
}

错误码

参考错误码。