锁设置-基本信息
锁电量更新
请求链接:
/room/uploadElectricQuantity请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| electricQuantity | String | Y | "100" | 电量百分比 |
| electricQuantityStandby | int | N | 100 | 备用电池百分比 |
| lockId | String | Y | "9418451" | 锁ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
| data | Object | 返回数据 |
json
{
"errorCode": 0,
"description": "success",
"errorMsg": "success",
"data": {
"electricQuantityDate": 1718075987550
}
}修改锁名
请求链接:
/lock/updateLockName请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| lockId | String | Y | "9418451" | 锁ID |
| lockName | String | Y | "Daisy" | 锁名称 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | Int | 错误码 |
| errmsg | String | 错误信息 |
| description | String | 描述 |
json
{
"errcode": 0,
"errmsg": "none error message",
"description": "表示成功或是。"
}修改电子钥匙名
说明: 此接口不属于锁分类，建议移至钥匙管理模块
请求链接:
/key/modifyKeyName请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| keyId | String | Y | "108842951" | 钥匙ID |
| lockId | String | Y | "9418451" | 锁ID |
| keyName | String | Y | "Daisy" | 钥匙名称 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
json
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}创建锁分组
请求链接:
/keyGroup/add请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| groupName | String | Y | "新的分组" | 新分组名称 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| groupId | Int | 分组ID |
json
{
"groupId": 508541
}修改钥匙分组
请求链接:
/keyGroup/modifyGroup请求方式:
POST
说明: 选择之后自动更新锁钥匙的分组
- 参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| keyId | String | Y | "9418481" | 钥匙ID |
| groupId | String | Y | "2" | 分组ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
json
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}设置锁分组
请求链接:
/keyGroup/setGroup请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| lockId | String | Y | "2" | 锁ID |
| groupId | String | Y | "5" | 分组ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
json
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}修改开锁密码
请求链接:
/room/modifyPwd请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| lockId | String | Y | "9418481" | 锁ID |
| password | String | Y | "MjM1LDIzOCwyMzcsMjMyLDIzOSwyMjYsMjMzLDIzNiwyMjcsNzA%3D" | 新密码 |
| passwordType | String | Y | "1" | 修改方式：1-通过APP走蓝牙修改，不传默认1，必需先通过APP蓝牙修改后调用该接口 2-通过网关或WiFi锁远程修改，是WiFi锁或有连接网关，可以传2，接口返回成功则修改生效 3-NB-IoT，如果是NB-IoT锁，则可以传3 不传默认1 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
json
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}微信开锁二维码
请求链接:
/room/getWeChatQrCode请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| lockId | String | Y | "9418481" | 锁ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| qrCodeImg | String | 二维码图片（Base64编码） |
json
{
"qrCodeImg": "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..."
}更新锁固件版本
请求链接:
/lock/updateLockInfo请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| lockId | int | Y | 2 | 锁ID |
| fwVersion | String | Y | "1.0.0" | 固件版本 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
| data | Object | 返回数据 |
json
{
"errorCode": 0,
"description": "success",
"errorMsg": "success",
"data": {}
}