创建临时密码

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

本文介绍创建临时密码的 API。

接口描述

创建一个新的门锁临时密码。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	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	周期性信息
relate_dev_list	array[Stirng]	true	关联设备列表（长度1，仅支持蓝牙门锁配件）

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	JSONObject

result 说明

参数名	类型	说明
id	Long	密码 ID

请求示例

POST: /v1.0/devices/vdevo15345926009****/door-lock/temp-password

{
  "password": "956FAD7****09C68E168B77",
  "password_type": "ticket",
  "ticket_id": "****",
  "effective_time": 1579156726,
  "invalid_time": 1579243126,
  "name": "test",
  "phone": 11233213,
  "time_zone": "",
  "schedule_list": [
    {
      "effective_time": 720,
      "invalid_time": 1080,
      "working_day": 0
    }
  ]
}

返回示例

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

错误码

参考错误码。