修改临时密码

更新时间：2024-08-19 06:21:05下载pdf

本文介绍修改临时密码的 API。

接口描述

修改门锁的临时密码。

PUT: /v1.0/devices/{device_id}/door-lock/temp-passwords/{password_id}/modify-password

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

body 说明

参数名	类型	是否必填	说明
name	String	true	密码名称
password	String	true	密码原文长度为 Wi-Fi 锁：7 Zigbee 锁/蓝牙锁：6 加密算法：AES 模式：ECB pkcs7padding 数据块：128 位密钥：通过接口获取的临时 ticket_key，使用开发者 accessKey AES 解密后的原始密钥输出是格式：hex
effective_time	Long	true	生效时间（10 位时间戳）
invalid_time	Long	true	过期时间（10 位时间戳）
password_type	String	true	密码加密类型：ticket
phone	String	false	手机号码
type	Integer	false	密码有效类型， 1：一次性有效 0：有效范时间围内一直有效
time_zone	String	false	时区。需要周期性功能，则需填入此项
ticket_id	String	true	临时密钥 ID
schedule_list	List	false	周期性信息

schedule_list 说明

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

参数名	类型	说明
result	Boolean	操作结果

PUT: /v1.0/devices/vdevo15345926009****/door-lock/temp-passwords/xxx/modify-password

{
  "phone": "",
  "effective_time": "",
  "invalid_time": "",
  "password": "",
  "password_type": "ticket",
  "ticket_id": "xxx"
}

{
    "result": true,
    "t": 1542626129429,
    "success": true
}