修改临时密码

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

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

接口描述

修改门锁的临时密码。

接口地址

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

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备 ID
password_idLonguritrue密码 ID

body 说明

参数名类型参数位置是否必填说明
nameString true密码名称
passwordString true
  • 密码原文长度为
    • Wi-Fi 锁:7
    • Zigbee 锁/蓝牙锁:6
  • 加密算法:AES
  • 模式:ECB pkcs7padding
  • 数据块:128 位
  • 密钥:通过接口获取的临时 ticket_key,使用开发者 accessKey AES 解密后的原始密钥
  • 输出是格式:hex
effective_timeLong true生效时间(10 位时间戳)
invalid_timeLong true过期时间(10 位时间戳)
password_typeString true密码加密类型:ticket
phoneString false手机号码
typeInteger false密码有效类型,
  • 1:一次性有效
  • 0:有效范时间围内一直有效
time_zoneString false时区。需要周期性功能,则需填入此项
ticket_idString true临时密钥 ID
schedule_listList false周期性信息

schedule_list 说明

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

返回参数

参数名类型说明
resultBoolean操作结果

请求示例

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
}

错误码

参考 错误码