获取开门记录/告警记录

更新时间：2023-12-07 03:34:01

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

接口描述

获取开门记录/告警记录

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备id
target_standard_dp_codes	String	query	true	需要查询的标准dpCode(多个时以逗号分割)
start_time	Long	query	true	时间范围的开始时间, 不需要时间范围时传0
end_time	Long	query	true	时间范围的结束时间, 不需要时间范围时传0
page_no	Integer	query	true	当前页数(从1开始计数)
page_size	Integer	query	true	每页展示的条数

返回参数

参数名	类型	说明
result	OpenApiPagination

result 说明

参数名	类型	说明
has_more	Boolean
total_pages	Integer
unread_count	Integer
total	Integer
records	List

records 说明

参数名	类型	说明
record_id	String	记录Id
media_info_list	List	多媒体信息
union_unlock_info	List	组合解锁信息集合
unlock_name	String	解锁方式名称
gmt_create	Long	创建时间
dps	List	dp信息
avatar	String	用户头像
member_bindable_flag	Integer	是否可以关联人. 1- 可关联人; 0- 不能关联人(可能已经关联过了)
user_id	String	用户id
user_name	String	用户名
record_type	String	记录类型. alarm-告警类型的记录; normal-普通开门记录

media_info_list 说明

参数名	类型	说明
file_url	String	封面图全路径
file_key	String	文件Key
bucket	String	文件bucket
file_path	String	封面图相对路径
media_url	String	视频全路径
media_key	String	视频Key
media_path	String	视频相对路径
media_bucket	String	视频所属的bucket

union_unlock_info 说明

参数名	类型	说明
user_name	String	用户名
opmode	String	解锁类型
unlock_name	String	解锁方式名称

请求示例

GET: /v1.0/devices/vdevo162322644587871/door-lock/records?targetStandardDpCodes=unlock_password,unlock_card&startTime=0&endTime=0&pageNo=1&pageSize=10

返回示例

{
    "result": {
        "records": [
            {
                "gmt_create": 1624604728299,
                "unlock_name": "密码1",
                "dps": [
                    {
                        "unlock_password": "1"
                    }
                ],
                "user_name": "古树🐟🐟🐟",
                "avatar": "https://images.tuyacn.com/smart/user_avatar/ay1565317415087U6QVp/F062FD1C-CA44-440A-9AE5-E270BE4826DD.png?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1624606578%3B1624610178%26q-key-time%3D1624606578%3B1624610178%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D467422052c41744943fa1c734ed9a44ad2ad7fe1",
                "record_type": "alarm",
                "record_id": "162460b8cfcbb6-d583-11eb-adea-0242878ef2664728299",
                "user_id": "30665363",
                "member_bindable_flag": 0
            }
        ],
        "total_pages": 1,
        "total": 1,
        "has_more": false
    },
    "t": 1624606578846,
    "success": true
}

错误码

参考错误码。