创建临时密码

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

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

接口描述

创建临时密码

接口地址

POST: /v1.0/smart-lock/device/{device_id}/template/temp-password

请求参数

参数名	类型	参数位置	是否必填	说明

body 说明

参数名	类型	参数位置	是否必填	说明
name	String		false	临时密码名称，为空则为默认名称
pwd_id	Long		false	临时密码编号
msg_id	Long		false	消息编号
uid	String		false
password	String		false	密码原文长度为 Wi-Fi 锁：7 Zigbee 锁/蓝牙锁：6 加密算法：AES 模式：ECB pkcs7padding 数据块：128 位密钥：通过接口获取的临时 ticket_key，使用开发者 accessKey AES 解密后的原始密钥输出是格式：hex
effective_time	Long		false	生效时间（10 位时间戳）
invalid_time	Long		false	过期时间（10 位时间戳）
password_type	String		false	密码加密类型 ticket
ticket_id	String		false	临时密钥 ID
phone	String		false	手机号码
type	Integer		false	密码有效类型 1：一次性有效 0：有效范时间围内一直有效
time_zone	String		false	时区。需要周期性功能，则需填入此项
bluetooth_symbolic	Boolean		false	带网关的蓝牙门锁专用参数 true：通过网关下发临时密码数据 false：不下发数据到门锁，仅保存记录
schedule_list	List		false	周期性信息
sn	String		false	蓝牙产品的密码的序号
check_name	Boolean		false	是否校验名称重复 true：是 false：否
country_code	String		false	用户的国家码
iot_uid	String		false	iot平台用户id，这个参数可用于发送短信
app_id	Integer		false	业务的appId
available_time	Integer		false	用户的国家码
sms_param_map	Map		false	发送短信时的动态参数集合
sms_template	String		false	短信模板(如果传了，则以这个模板为准)
dp_tunnel	Integer		false	信息下发的信道 1、非云端下发2、云端下发
is_record	Boolean		false	是否添加记录
device_id	String	uri	true	设备 Id

schedule_list 说明

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

返回参数

参数名	类型	说明
result	TemplatePwdResponse

result 说明

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

请求示例

POST: /v2.0/smart-lock/devices/vdevo15345926009****/temp-passwords

错误码

参考错误码。