授权管理员
授权管理员列表
请求链接:
/authorizedAdmin/list请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | String | Y | "1" | 页码 |
| pageSize | String | Y | "20" | 每页数量 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 管理员列表 |
| uid | Int | 用户ID |
| keyStatus | String | 钥匙状态 |
| lockNum | Int | 锁数量 |
| endDate | Long | 结束时间 |
| name | String | 姓名 |
| headUrl | String | 头像URL |
| userid | String | 用户账号 |
| startDate | Long | 开始时间 |
| keyType | Int | 钥匙类型 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
json
{
"list": [
{
"uid": 16474761,
"keyStatus": "110402",
"lockNum": 1,
"endDate": 0,
"name": "哈伦",
"headUrl": "",
"userid": "18682150237",
"startDate": 0,
"keyType": 2
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 1
}管理员详情
请求链接:
/authorizedAdmin/detail请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| uid | Int | Y | 11 | 用户ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| uid | Int | 用户ID |
| keyStatus | Int | 钥匙状态 |
| lockNum | Int | 锁数量 |
| endDate | Long | 结束时间 |
| startDate | Long | 开始时间 |
| isRemoteUnlock | Int | 是否支持远程开锁 |
| name | String | 姓名 |
| userid | String | 用户账号 |
| lockList | Array | 锁列表 |
| lockId | Int | 锁ID |
| lockAlias | String | 锁别名 |
| groupList | Array | 分组列表 |
| groupId | Int | 分组ID |
| name | String | 分组名称 |
| lockList | Array | 锁列表 |
| keyId | Int | 钥匙ID |
| lockId | Int | 锁ID |
| lockAlias | String | 锁别名 |
| lockUserNo | Int | 锁用户编号 |
json
{
"uid": 667,
"keyStatus": 110402,
"lockNum": 1,
"endDate": 1712285880000,
"startDate": 1712026680000,
"isRemoteUnlock": 0,
"name": "浓浓的",
"userid": "15099999999",
"lockList": [
{
"lockId": 1759,
"lockAlias": "HWFWYGFWGG2"
}
],
"groupList": [
{
"groupId": 456,
"name": "未分组",
"lockList": [
{
"keyId": 11006,
"lockId": 1759,
"lockAlias": "HWFWYGFWGG2",
"lockUserNo": 0
}
]
}
]
}管理员姓名/有效期/远程开锁修改
请求链接:
/authorizedAdmin/update请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| uid | String | Y | "16474761" | 用户ID |
| keyName | String | N | "哈伦1" | 修改姓名时传入 |
| endDate | String | N | "1692259259000" | 修改有效期传入 |
| startDate | String | N | "1689577200000" | 修改有效期传入 |
| remoteEnable | String | N | "1" | 是否远程开锁传入 1:打开 2:关闭 |
| isOnlyManageSelf | int | N | 0 | 是否仅管理自己创建的用户 |
| keyType | int | N | 1 | 钥匙类型，只支持：永久改限时 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
json
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}删除授权管理员
请求链接:
/authorizedAdmin/delete请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| uid | String | Y | "16474761" | 用户ID |
| includeUnderlings | String | N | "0" | 是否删除授权管理员发送的钥匙。1是，0否 |
| lockIds | array | N | [100, 101] | 锁ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
json
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}增加授权管理员
请求链接:
/authorizedAdmin/add请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| createUser | String | Y | "0" | 发送的邮箱/手机号未注册时重新调用接口加这个字段传1 |
| endDate | String | N | "0" | 限时需传入；永久传"0" |
| isRemoteUnlock | String | Y | "1" | 是否支持远程开锁：1-是、2-否 |
| keyGroupIdList | String | Y | "[503859]" | 分组ID列表（JSON字符串） |
| lockIdList | String | Y | "[]" | 锁ID列表（JSON字符串） |
| name | String | Y | "15555" | 姓名 |
| startDate | String | N | "0" | 限时需传入；永久传"0" |
| userid | String | Y | "18682150237" | 用户账号（手机号/邮箱） |
| countryCode | String | Y | "" | 国家区号（createUser=1时使用） |
| usernameType | Int | N | 1 | 1为手机号，2为邮箱（createUser=1时使用） |
| isOnlyManageSelf | int | Y | 0 | 是否仅管理自己发送的钥匙 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| uid | Int | 用户ID |
json
{
"uid": 16474761
}取消授权管理员
请求链接:
/authorizedAdmin/unauthorize请求方式:
POST
说明：取消的是所有锁的管理员权限
- 参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| uid | int | Y | 1061 | 用户UID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
json
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success"
}获取授权管理员下锁列表
请求链接:
/authorizedAdmin/ownLockList请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| uid | int | Y | 1061 | 用户UID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| uid | Int | 用户ID |
| groupName | String | 分组名称 |
| groupType | Int | 分组类型 |
| groupId | Int | 分组ID |
| lockList | Array | 锁列表 |
| lockId | Int | 锁ID |
| lockAlias | String | 锁别名 |
json
[
{
"uid": 752,
"groupName": "未分组",
"groupType": 0,
"groupId": 524,
"lockList": [
{
"lockId": 1822,
"lockAlias": "TMH_cf6ad1f4cbab"
}
]
}
]