临时密码详情接口

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

本文介绍临时密码详情接口的 API。

接口描述

获取门锁的临时密码详情

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备id
password_id	Long	uri	true	密码id

返回参数

参数名	类型	说明
result	TemplatePwdSearchResultVO

result 说明

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

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/2876895

返回示例

{
    "tid": "f19673593eda11ed84fd2237f0528b74",
    "result": {
        "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"
    },
    "t": 1664334559805,
    "success": true
}

错误码

参考错误码。