修改密码

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

修改之前生成的随机密码或自定义密码，主要有两种修改方式：

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

开发者可以集成APP SDK开发自己的APP，调用修改密码方法修改密码，再调用该接口（changeType传1），将修改后的密码同步到云端。

（2）通过网关或WiFi锁远程修改：

如果锁有连接网关设备，则可以直接调用该接口（changeType传2），通过网关或WiFi锁直接修改锁里的密码。

支持修改密码名称、有效期或修改密码，允许只修改其中的一项，或同时修改三项。

修改密码名称时只需要传keyboardPwdName，不用传changeType；

修改有效期startDate和endDate必传, 如果不传startDate，即使API请求成功也不会生效；

修改密码时传newKeyboardPwd。

1 HTTP请求方法及示例


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


xxxxxxxxxx
11
1
curl --location -g --request POST 'https://api.sciener.com/v3/keyboardPwd/change' \
2
--data-urlencode 'clientId=fd2ff35ee3xxxxxx' \
3
--data-urlencode 'accessToken=780f7671b6e6bxxxxxxx' \
4
--data-urlencode 'lockId=24451' \
5
--data-urlencode 'keyboardPwdId=123456' \
6
--data-urlencode 'keyboardPwdName=小明' \
7
--data-urlencode 'newKeyboardPwd=689768' \
8
--data-urlencode 'startDate=1626945087000' \
9
--data-urlencode 'endDate=1846945087000' \
10
--data-urlencode 'changeType=2' \
11
--data-urlencode 'date=1626945087000'

2 参数说明

名称	类型	是否必需	描述
clientId	String	Y	创建应用分配的client_id
accessToken	String	Y	访问令牌，通过获取访问令牌接口获取
lockId	Int	Y	锁ID，由锁初始化接口生成
keyboardPwdId	Int	Y	键盘密码ID
keyboardPwdName	String	N	新的密码名称
newKeyboardPwd	String	N	新的密码
startDate	Long	N	修改后密码有效期开始时间（时间戳，单位毫秒）
endDate	Long	N	修改后密码有效期结束时间（时间戳，单位毫秒）
changeType	Int	Y	修改方式: 1-通过APP走蓝牙修改，不传默认1，必需先通过APP SDK蓝牙修改后调用该接口 2-通过网关或WiFi锁修改，如果是WiFi锁或有连接网关，则可以传2，直接调用该接口修改生效 3-NB-IoT，如果是NB-IoT锁，可以传3，通过NB网络下发指令，要等NB唤醒才会下发生效。
date	Long	Y	当前时间（时间戳，单位毫秒）

3 返回参数及示例

参数	类型	描述
errcode	Int	错误码
errmsg	String	错误信息
description	String	错误描述


xxxxxxxxxx
5
1
{
2
    "errcode": 0, 
3
    "errmsg": "none error message",
4
    "description":"表示成功或是"
5
}