删除临时密码

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

本文介绍删除临时密码的 API。

接口描述

删除临时密码

接口地址

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

请求参数

body 说明

参数名类型参数位置是否必填说明
temp_pwd_requestTemplatePwdRequestbodyfalse密码数据
bodyBodybodytrue

temp_pwd_request 说明

参数名类型参数位置是否必填说明
nameString false临时密码名称,为空则为默认名称
pwd_idLong false临时密码编号
msg_idLong false消息编号
passwordString false
  • 密码原文长度为
    • Wi-Fi 锁:7
    • Zigbee 锁/蓝牙锁:6
  • 加密算法:AES
  • 模式:ECB pkcs7padding
  • 数据块:128 位
  • 密钥:通过接口获取的临时 ticket_key,使用开发者 accessKey AES 解密后的原始密钥
  • 输出是格式:hex
effective_timeLong false生效时间(10 位时间戳)
invalid_timeLong false过期时间(10 位时间戳)
phoneString false手机号码
typeInteger false密码有效类型
  • 1:一次性有效
  • 0:有效范时间围内一直有效
time_zoneString false时区。需要周期性功能,则需填入此项
bluetooth_symbolicBoolean false带网关的蓝牙门锁专用参数
  • true:通过网关下发临时密码数据
  • false:不下发数据到门锁, 仅保存记录
schedule_listList false周期性信息
snString false蓝牙产品的密码的序号
check_nameBoolean false是否校验名称重复
  • true:是
  • false:否
country_codeString false用户的国家码
iot_uidString false涂鸦iot开发平台用户id, 这个参数可用于发送短信
app_idInteger false业务的appId
available_timeInteger false用户的国家码
sms_param_mapMap false发送短信时的动态参数集合
sms_templateString false短信模板
dp_tunnelInteger false
  • 信息下发的信道
  • 1、非云端下发
  • 2、云端下发
is_recordBoolean false是否添加记录
request_idLong false请求方的业务流水编号,一般是数据库的id字段或其他唯一标志
dev_id_listList false设备编号

body 说明

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

schedule_list 说明

参数名类型参数位置是否必填说明
effective_timeLong false开始时间。分钟形式存放,比如"07:30"的话,该值就是7x60+30=450
invalid_timeLong false结束时间。分钟形式存放,比如"08:30"的话,该值就是8x60+30=510
working_dayInteger false星期, 每个值累加:
  • 星期天:1
  • 星期一:2
  • 星期二:4
  • 星期三:8
  • 星期四:16
  • 星期五:32
  • 星期六:64

返回参数

参数名类型说明
resultTemplatePwdResponse

result 说明

参数名类型说明
pwd_idLong临时密码编号

请求示例

DELETE: /v1.0/devices/6c7129x1yanlxgwx/door-lock/template/temp-password/12345
{
  "dpTunnel": 1
}

返回示例

{
    "tid": "c6b6e70e3edd11ed84fd2237f0528b74",
    "result": {
    },
    "t": 1664335776208,
    "success": true
}

错误码

参考 错误码