获取随机密码

https://api.sciener.com/v3/keyboardPwd/get

从云端获取一个6-9位数字的随机密码用于开锁，密码由云端的算法规则生成，不需要锁连接网关就可以获取，位数主要由密码类型和有效期长短决定，密码随机生成，不可定制，需要自定义密码请参考添加自定义密码接口。

限期密码时间跨度最大不能超过一年，密码有效期时间粒度只能精确到小时，即开始时间和结束时间只能为整点，例如startDate传的时间是：19:20，则生成的密码有效期其实会是：19:00 开始生效，所以建议开发者传过来就是整点的时间戳。

1 HTTP请求方法及示例


xxxxxxxxxx
1
1
POST, ContentType:application/x-www-form-urlencoded


xxxxxxxxxx
9
1
curl --location -g --request POST 'https://api.sciener.com/v3/keyboardPwd/get' \
2
--data-urlencode 'clientId=fd2ff35ee3xxxxxx' \
3
--data-urlencode 'accessToken=780f7671b6e6bxxxxxxx' \
4
--data-urlencode 'lockId=24451' \
5
--data-urlencode 'keyboardPwdType=3' \
6
--data-urlencode 'keyboardPwdName=test' \
7
--data-urlencode 'startDate=1626945087000' \
8
--data-urlencode 'endDate=1636945087000' \
9
--data-urlencode 'date=1626945087000'

2 参数说明

名称	类型	是否必需	描述
clientId	String	Y	创建应用分配的client_id
accessToken	String	Y	访问令牌，通过获取访问令牌接口获取
lockId	Int	Y	锁ID，由锁初始化接口生成
keyboardPwdType	Int	Y	密码类型，请参考2.1节的说明
keyboardPwdName	String	N	密码名称
startDate	Long	Y	有效期开始时间（时间戳，单位毫秒）
endDate	Long	N	有效期结束时间（时间戳，单位毫秒）
date	Long	Y	当前时间（时间戳，单位毫秒）

2.1 密码类型:

注意：当设置密码为循环类型时，startDate 和 endDate请传距离你循环类型最近的当天时间戳，系统会取设置的开始日期和时间段，并从开始日期开始判断当日是否和该密码的循环类型一致，从而决定是否生效。例：

设置周末循环，8：00 AM--5：00 PM，最近的周末（周六和周日）为2026-01-03，传参应为：keyboardPwdType = 5， startDate = 1767398400000（2026-01-03 08:00:00），endData = 1767430800000（2026-01-03 17:00:00）；那么系统会从2026-01-03日开始判断当日是否为周末，如果当日为周末，密码生效，有效时间段为 8：00 AM--5：00 PM；当日非周末，密码失效。

类型	参数值	描述
单次	1	只能在开始时间后6小时内使用一次
永久	2	从开始时间开始永久有效，必需在开始时间24小时内使用一次，否则将失效
限期	3	在开始和结束时间内有效，必需在开始时间24小时内使用一次，否则将失效
删除	4	在锁上使用后会删除之前在锁上使用过的密码
周未循环	5	在周未开始和结束时间指定时间段内有效
每日循环	6	每天开始和结束时间指定时间段内有效
工作日循环	7	工作日开始和结束时间指定的时间段内有效
周一循环	8	每周一开始和结束时间指定时间段内有效
周二循环	9	每周二开始和结束时间指定时间段内有效
周三循环	10	每周三开始和结束时间指定时间段内有效
周四循环	11	每周四开始和结束时间指定时间段内有效
周五循环	12	每周五开始和结束时间指定时间段内有效
周六循环	13	每周六开始和结束时间指定时间段内有效
周天循环	14	每周日开始和结束时间指定时间段内有效

3 返回参数及示例

参数	类型	描述
keyboardPwd	String	键盘密码
keyboardPwdId	Int	键盘密码ID


xxxxxxxxxx
4
1
{
2
    "keyboardPwd": "0563456",
3
    "keyboardPwdId": 10236
4
}