通过密码删除
https://euapi.ttlock.com/v3/keyboardPwd/deleteByCode
删除之前生成的随机密码或自定义密码,主要有两种删除方式:
(1)通过APP或小程序蓝牙连接锁删除:
开发者可以集成APP SDK开发自己的APP,调用删除密码方法从锁里删除密码,再调用该接口(deleteType传1),将密码从云端的数据库里删除。
(2)通过网关或WiFi锁远程删除:
如果锁有连接网关设备,则可以直接调用该接口(deleteType传2),通过网关或WiFi锁把密码从锁里删除。
1 HTTP请求方法及示例
POST, ContentType:application/x-www-form-urlencodedjavascript
curl --location -g --request POST 'https://euapi.ttlock.com/v3/keyboardPwd/deleteByCode' \
--data-urlencode 'clientId=fd2ff35ee3xxxxxx' \
--data-urlencode 'accessToken=780f7671b6e6bxxxxxxx' \
--data-urlencode 'lockId=24451' \
--data-urlencode 'keyboardPwd=123456' \
--data-urlencode 'deleteType=2' \
--data-urlencode 'date=1626945087000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| keyboardPwd | String | Y | 密码 |
| deleteType | Int | Y | 删除方式: 1-通过APP走蓝牙删除,不传默认1,必需先通过APP蓝牙删除后再调用该接口 2-通过网关或WiFi锁删除,如果是WiFi锁或有连接网关,则可以传2,直接调用该接口从锁里删除密码 3-NB-IoT,如果是NB-IoT锁,可以传3,通过NB网络删除,待NB唤醒后下发删除指令。 |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | Int | 错误码 |
| errmsg | String | 错误信息 |
| description | String | 错误描述 |
{
"errcode": 0,
"errmsg": "none error message",
"description":"表示成功或是"
}