获取门锁的临时密码列表

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

本文介绍获取门锁的临时密码列表的 API。

接口描述

获取门锁的临时密码列表，可以查看有效、失效等多种数据

接口地址

GET: /v1.0/devices/{device_id}/door-lock/template/temp-password

请求参数

参数名	类型	参数位置	是否必填	说明

body 说明

参数名	类型	参数位置	是否必填	说明
is_record	Boolean		false	是否包含记录
data_type	Integer		false	数据类型 0：仅查看有效数据 1：仅查看失效数据 2：查看所有数据
page_size	Integer		false	每页记录数
offset	Integer		false	偏移量
device_id	String	uri	true	设备id

返回参数

参数名	类型	说明
result	OpenApiPagination

result 说明

参数名	类型	说明
total	Integer	数据总数
unread_count	Integer
total_pages	Integer	总页数
records	List	分页数据
has_more	Boolean	是否还有更多数据

records 说明

参数名	类型	说明
pwd_id	Long	密码编号
password	String	密码
pwd_type	Integer	当前密码的类型 0-周期性密码 1-一次性密码
msg_id	Integer	密码信息编号
pwd_type_code	String	密码类型 once-仅限一次使用的离线密码 temp-临时密码(自定义密码)
name	String	密码名称
gmt_create	Long	密码创建时间(毫秒)
effective_time	Long	密码生效时间(毫秒)
expired_time	Long	密码失效时间(毫秒)
phone	String	手机号码(带国家码)，比如: 86-15158065546
schedule_details	List	周期性信息, 只有类型为周期性密码时才可能会有改值
sn	Integer	周期性密码的序列号
operate	String	操作 ADD 新增 MODIFY 修改 DELETE 删除
delivery_status	String	投递状态. 取值: 投递状态 ONGOING 投递中 SUCCESS 成功 FAILED 失败
dev_name_list	List	可以解锁的设备名称列表
dev_id_list	List	可以解锁的设备编号列表
dev_ack	Integer	设备返回状态根据dp定义设置

schedule_details 说明

参数名	类型	说明
effective_time	Long	开始时间。分钟形式存放，比如"07:30"的话，该值就是7x60+30=450
invalid_time	Long	结束时间。分钟形式存放，比如"08:30"的话，该值就是8x60+30=510
working_day	Integer	星期, 每个值累加：星期天：1 星期一：2 星期二：4 星期三：8 星期四：16 星期五：32 星期六：64
time_zone_id	String	时间区域
all_day	Boolean	是否是全天

请求示例

GET: /v1.0/devices/6c7129x1yanlxgwx/door-lock/template/temp-password

{
  "isRecord": "true",
  "dataType": "0"
}

返回示例

{
    "tid": "1e5e62243ed811ed84fd2237f0528b74",
    "result": {
        "records": [
            {
                "effective_time": 1664269200,
                "schedule_details": [
                    {
                        "effective_time": 0,
                        "working_day": 127,
                        "all_day": false,
                        "invalid_time": 1439
                    }
                ],
                "pwd_id": 2876895,
                "expired_time": 1666861200,
                "password": "E86342BEF4228A1E741E38A5900FA61A",
                "operate": "CREATE",
                "name": "test9",
                "sn": -1,
                "msg_id": 81,
                "delivery_status": "ONGOING"
            },
            {
                "effective_time": 1664269200,
                "schedule_details": [
                    {
                        "effective_time": 0,
                        "working_day": 127,
                        "all_day": false,
                        "invalid_time": 1439
                    }
                ],
                "pwd_id": 2873619,
                "expired_time": 1666861200,
                "dev_ack": 2,
                "password": "080A9B713292AEE8203ADA6141F721E2",
                "operate": "DELETE",
                "name": "test13",
                "sn": 49,
                "msg_id": 80,
                "delivery_status": "FAILED"
            },
            {
                "effective_time": 1664269229,
                "schedule_details": [
                    {
                        "effective_time": 0,
                        "working_day": 127,
                        "all_day": false,
                        "invalid_time": 1439
                    }
                ],
                "pwd_id": 2871896,
                "expired_time": 1666861214,
                "password": "BC981F3595A36532EC6778EEE50DF3CE",
                "name": "测试",
                "sn": 48,
                "msg_id": 74,
                "delivery_status": "SUCCESS"
            }
        ],
        "has_more": true
    },
    "t": 1664333346974,
    "success": true
}

错误码

参考错误码。