用户管理
用户管理模块负责门锁用户的增删改查操作，包括添加用户、删除用户、修改用户权限、转移锁所有权、恢复出厂设置等功能。
概述
用户管理主要包括以下功能：
- 用户增删改：添加、删除、修改门锁用户及其权限
- 批量清理：基于服务器列表批量清理本地用户
- 锁所有权转移：将门锁转移给新的超级管理员
- 恢复出厂设置：清除所有用户数据，恢复门锁初始状态
删除用户
删除指定的门锁用户及其权限。
指令码
0x3002
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| LockID | 字符串 | 40 | 锁 ID |
| AuthUserID | 字符串 | 20 | 授权者 ID（管理员角色） |
| KeyID | 字符串 | 40 | 钥匙 ID |
| DelUserID | 字符串 | 20 | 被删除的用户 ID |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | 鉴权码长度 |
| AuthCode | 字符串 | 变长 | 鉴权码 首次请求可填写附加信息，用于锁验证用户合法性 |
鉴权码计算
鉴权码计算方法参考 加密与签名 文档。
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |
清理用户
基于服务器端的用户列表，批量清理门锁本地不存在于列表中的用户。
指令码
0x300C
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| LockID | 字符串 | 40 | 锁 ID |
| AuthUserID | 字符串 | 20 | 授权者 ID（管理员角色） |
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
| UserNoLength | 整型 | 2 | 从服务器上拉取的 lockUserNo 列表长度 |
| UserNoList | 整型 | 变长 | 从服务器上拉取的 lockUserNo 列表 |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | 鉴权码长度 |
| AuthCode | 字符串 | 变长 | 鉴权码 首次请求可填写附加信息，用于锁验证用户合法性 |
使用场景
清理用户功能适用于服务器端用户列表与门锁本地用户列表不一致时的同步场景。门锁会保留列表中的用户，删除其他所有用户。
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |
修改用户
修改已存在用户的权限和属性。
指令码
0x3003
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| LockID | 字符串 | 40 | 锁 ID |
| AuthUserID | 字符串 | 20 | 授权者 ID（管理员角色） |
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
| OpenMode | 整型 | 1 | 开锁方式 |
| KeyType | 整型 | 1 | 钥匙类型0: 普通1: 临时（到期自动删除） |
| StartDate | 整型 | 4 | 启用日期（UNIX 时间） |
| ExpireDate | 整型 | 4 | 停用日期（UNIX 时间） |
| UseCountLimit | 整型 | 2 | 使用次数限制0xFFFF: 不限次数 |
| IsRound | 整型 | 1 | 是否循环 |
| WeekRound | 整型 | 1 | 循环周期 Bit0-6 置位分别代表周日至周六 |
| StartHour | 整型 | 1 | 开始小时 |
| StartMin | 整型 | 1 | 开始分钟 |
| EndHour | 整型 | 1 | 结束小时 |
| EndMin | 整型 | 1 | 结束分钟 |
| Role | 整型 | 1 | 用户角色0: 普通用户1: 管理员0xff: 超级管理员 |
| Password | 字符串 | 20 | 离线开锁时验证使用，为空则不验证 |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | 鉴权码长度 |
| AuthCode | 字符串 | 变长 | 鉴权码 首次填写房东授权码，二次交互时填写平台鉴权码 |
鉴权码计算
鉴权码计算方法参考 加密与签名 文档。
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |
转移锁
将门锁的所有权转移给新的超级管理员。
指令码
0x300D
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| LockID | 字符串 | 40 | 锁 ID |
| userID | 字符串 | 20 | 新超级管理员 ID |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | 鉴权码长度 |
| AuthCode | 字符串 | 变长 | 鉴权码 首次填写房东授权码，二次交互时填写平台鉴权码 |
重要提示
转移锁操作会将当前超级管理员的权限转移给新用户，请谨慎操作。
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |
恢复出厂设置
清除门锁的所有用户数据和配置，恢复到出厂状态。
指令码
0x3004
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| LockID | 字符串 | 40 | 锁 ID |
| AuthUserID | 字符串 | 20 | 授权者 ID（要求是超级管理员用户） |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | 鉴权码长度 |
| AuthCode | 字符串 | 变长 | 鉴权码 |
危险操作
恢复出厂设置会清除所有用户数据、密码、指纹等信息，且不可恢复。执行此操作前请确保已备份重要数据。
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |