添加锁用户 - Smart lock

向指定门锁下发添加用户指令，在设备端创建新的用户信息，支持配置用户名称、权限等级、开门方式（指纹 / 卡片 / 密码 / 人脸 / 掌纹）等参数。指令下发后，门锁将在本地生成用户记录，赋予对应开门权限。
重要提示：
用户名称需保证设备端唯一，避免与已有用户冲突。
不同开门方式需对应设备支持的录入流程（如指纹需引导用户按压采集）。
调用成功后将获取的data(指令包)通过蓝牙方式写入门锁设备。

使用场景：为家庭成员、访客新增授权用户，配置不同权限等级（如管理员 / 普通用户 / 临时用户）。

timeZone 时区 01-0C从东1区到东12区，81-8C西1区到西12区，00零时区

离线密码除了年月日时分秒

请求参数

Header 参数

Body 参数application/json

示例

{
    "effectiveTime": "14:37",
    "deviceId": "a0:10:8a:fd:de:f3",
    "childId": "63:2d:99:84:a1:fe",
    "effectiveDate": "2026-04-07",
    "failDate": "2026-11-28",
    "failTime": "07:14",
    "effectiveDays": "0,1,2,3,4,5,6",
    "password": "548699366",
    "name": "e",
    "isDoorMode": "1",
    "isEnterMenu": "1",
    "isLocked": "0",
    "isAlwaysOpen": "0",
    "isEffective": "0",
    "deviceState": "05",
    "agingType": "03"
}

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "成功",
    "total": 0,
    "data": "5B004001016929443A000101114000DC02695CB3DA48DE8507D56C2FAF7AEE2CEF97F9F591E220850B599B055FCEDAAFAFB0482BE2ED406E4062DD19DB719A50424F00B5726E",
    "success": true
}