生成离线临时密码

更新时间：2023-12-07 03:33:56下载pdf

本文介绍生成离线临时密码的 API。

接口描述

生成离线临时密码。

接口地址

POST: /v1.1/devices/{device_id}/door-lock/offline-temp-password

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID
offline_pwd_add_request	OfflinePwdAddRequest	body	true	离线密码信息

offline_pwd_add_request 说明

参数名	类型	是否必填	说明
effective_time	Long	false	生效时间（秒） 1. MULTIPLE(0)时, 必填 2. ONCE(1)/CLEAR_ALL(9), 取当前时间的整点。例如当前时间=‘2021-01-23 22:11:12’, 则该字段的值=‘2021-01-23 22:00:00’ 3. MULTIPLE(0)/CLEAR_ONE(8)，取时间的整点。比如传的时间是=‘2021-01-27 15:11:12’, 则该字段的最终值=‘2021-01-27 15:00:00’
invalid_time	Long	false	过期时间（秒） 1. MULTIPLE(0)时, 必填 2. ONCE(1), 该时间取当前时间的整点+6小时。例如，当前时间=‘2021-01-23 22:11:12’, 则该字段的值= ‘2021-01-24 04:00:00’ 3. CLEAR_ALL(9), 该时间是当前时间的整点+24小时。例如，当前时间=‘2021-01-23 22:11:12’, 则该字段的值= ‘2021-01-24 22:00:00’ 4. MULTIPLE(0)/CLEAR_ONE(8)，如果该字段有值, 取时间的整点。例如，传的时间是=‘2021-01-27 15:11:12’, 则该字段的最终值=‘2021-01-27 15:00:00’
name	String	false	密码名称
type	String	false	类型，multiple, 可以重复使用的离线密码；once, 仅限一次使用的离线密码；clear_one, 清除单个离线密码；clear_all, 清除所有离线密码
password_id	String	false	密码 ID，只有type=clear_one 时才需要传该值

返回示例

参数名	类型	说明
result	OfflinePwdAddResponse	离线密码结果

result 说明

参数名	类型	说明
offline_temp_password_id	String	密码 ID
offline_temp_password	String	密码内容
offline_temp_password_name	String	密码名称
effective_time	Long	生效时间（秒）
invalid_time	Long	过期时间（秒）

请求示例

POST: /v1.1/devices/6cdb36b2e489885fa57lzm/door-lock/offline-temp-password

返回示例

{
    "result": {
        "effective_time": 1623747600,
        "offline_temp_password_id": "2345011",
        "offline_temp_password": "0282554135",
        "invalid_time": 1623769200,
        "offline_temp_password_name": "name267"
    },
    "t": 1623748396631,
    "success": true
}

错误码

参考错误码。