获取临时密码列表

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

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

接口描述

获取门锁的临时密码列表。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID
valid	Boolean	query	false	是否有效

返回参数

参数名	类型	说明
result	List	门锁临时密码结果集

result 说明

参数名	类型	说明
id	Long	临时密码的编号
name	String	临时密码的名称
phase	Integer	密码状态 Zigbee: 1：待创建 2：正常 3：已冻结 4：已删除 5：创建失败 Wi-Fi: 0：已删除 1：待下发 2：已下发 3：待删除蓝牙: 0：已删除 1：待下发 2：已下发 3：待删除 7：下发失败
effective_time	Long	生效时间，10 位时间戳
invalid_time	Long	过期时间，10 位时间戳
phone	String	手机号码
time_zone	String	时区
delivery_status	Integer	操作确认状态,Zigbee 时返回 1:配置中 2:配置成功 3:配置失败 4:重复密码 5:密码已满 6:有效期重叠
schedule_list	List	周期性功能参数列表

schedule_list 说明

参数名	类型	说明
effective_time	Long	开始时间。分钟形式存放,，例如，"07:30"的取值为 7x60+30=450
invalid_time	Long	结束时间。分钟形式存放，例如，"07:30"的取值为 7x60+30=450
working_day	Integer	循环工作日。一周的时间用一个字节表示。 bit0 ~ bit6 分别代表周日~周六；1 表示有效，0 表示无效；最后一位以 0 表示。例如周一/周二/周五的表示为：00100110 = 38，最终 working_day=38

请求示例

GET: /v1.0/devices/vdevo15345926009****/door-lock/temp-passwords?valid=true

返回示例

{
    "result": [
        {
            "effective_time": 1530841779,
            "phase": 1,
            "time_zone": "Asia/Shanghai",
            "phone": "123547127362",
            "name": "租客A的密码",
            "invalid_time": 1530881779,
            "id": 1001,
            "delivery_status": 1
        }
    ],
    "t": 1542626129429,
    "success": true
}

错误码

参考错误码。