添加自定义密码

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

向锁里写入一个4-9位的自定义限期密码，自定义密码只支持限期、永久类型，有效期可以精确到分钟，没有像随机密码方案那样必需在24小时内使用的限制和同时间段个数限制。

自定义密码主要有两种写入方式：

（1）通过APP或小程序蓝牙连接锁添加：

开发者可以集成SDK开发自己的App，调用添加密码方法将密码添加到锁里，再调用该接口（addType = 1），将密码同步到云端，方便后续管理。注意：必需先通过SDK蓝牙添加后，再调用该接口；如果直接调用该接口，生成的密码只在云端，并不存在锁上，无法开锁！

（2）通过网关或WiFi锁远程添加：

如果锁有连接网关设备，则可以直接调用该接口（addType=2），通过网关或WiFi锁把密码添加到锁里。

WiFi锁如果开启了省电模式可以（addType=4）进行异步下发，异步下发相关介绍可以参考：远程开锁-WiFi锁

由于锁本身存储空间有限，最多只能写入250个自定义密码，超过个数限制会返回-3009的错误码，提示空间已满，需要先删除其他的，再添加。

1 HTTP请求方法及示例

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

xxxxxxxxxx
10
1
curl --location -g --request POST 'https://api.sciener.com/v3/keyboardPwd/add' \
2
--data-urlencode 'clientId=fd2ff35ee3xxxxxx' \
3
--data-urlencode 'accessToken=780f7671b6e6bxxxxxxx' \
4
--data-urlencode 'lockId=24451' \
5
--data-urlencode 'keyboardPwd=123456' \
6
--data-urlencode 'keyboardPwdName=陈文亮' \
7
--data-urlencode 'startDate=1626945087000' \
8
--data-urlencode 'endDate=1746945087000' \
9
--data-urlencode 'addType=2' \
10
--data-urlencode 'date=1626945087000'

2 参数说明

3 返回参数及示例

xxxxxxxxxx
3
1
{
2
    "keyboardPwdId": 24242
3
}