获取门锁告警记录

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

本文介绍获取门锁告警记录的 API。

接口描述

可以获取门锁的告警记录。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID
page_no	Integer	query	true	页号
page_size	Integer	query	true	分页大小
codes	String	query	false	告警功能标准功能 code，用半角逗号（,）隔开，默认查询通用告警 `hijack`：劫持告警 `alarm_lock`：通用告警 `doorbell`：门铃提醒

返回参数

参数名	类型	说明
result	Pagination

result 说明

参数名	类型	说明
total	Integer	总数
records	List	记录列表

records 说明

参数名	类型	说明
status	List	门锁告警列表
update_time	Long	状态变更时间
nick_name	String	用户名

status 说明

参数名	类型	说明
code	String	告警标准码
value	Object	状态值，劫持告警的 value 为触发劫持的标准状态码对应的解锁方式编号

请求示例

GET: /v1.0/devices/vdevo15345926009****/door-lock/alarm-logs?page_no=1&page_size=20&dp_codes=hijack

返回示例

{
    "result": {
        "records": [
            {
                "update_time": 1543297979,
                "status": {
                    "code": "hijack",
                    "value": "unlock_fingerprint-02"
                }
            }
        ],
        "total": 1
    },
    "t": 1542626129429,
    "success": true
}

错误码

参考错误码。