本文将对门锁用户相关开门能力对接进行说明,包含用户新增、多类型开门模式、修改、删除用户等全流程能力。1. 锁用户方案说明#
门锁用户采用一类开门模式对应一个独立用户的隔离模式,不同开门方式相互独立:创建指纹生成指纹用户、创建卡片生成卡片用户、创建自定义数字密码生成密码用户,数据互不干扰。所有用户配置下发后,必须通过蓝牙连接门锁写入指令数据包,锁端开门权限才会 生效。自定义密码补充规则
开门介质选择自定义密码时,支持设置 6-10 位纯数字;无离线密码 24 小时强制使用限制,支持永久、限时、循环三类时效,有效期内可重复开门。2. 新增锁用户完整流程(必看)#
调用添加锁用户,填写用户名、开门模式、各类权限时效、时区等参数,接口返回指令数据包;
将数据包通过蓝牙写入门锁设备,门锁本地生成独立用户记录;
必须调用模式专属上报接口完成云端入库:自定义密码调用上报密码、指纹调用上报指纹、卡片调用上报卡片、人脸调用上报人脸人脸上报、掌纹调用上报掌纹。
重要提示:仅蓝牙写入但未上报,云端无该用户数据,列表查询无法展示。
不同开门介质对应门锁专属采集流程,例如指纹录入需引导用户按压门锁采集模块。3. 用户信息查询#
支持查询门锁全部用户列表、单条用户完整详情,展示开门介质、时效、权限等基础信息,用于页面列表渲染与编辑表单回显。4. 修改锁用户#
锁用户支持全维度信息修改,和离线密码仅能修改名称存在明显区别:自定义密码可修改密码数字,指纹 / 卡片 / 人脸 / 掌纹 / 密码均可调整时效、各类权限配置。
修改流程:调用修改锁用户接口,传入更新后的用户参 数,生成新蓝牙指令数据包; 5. 删除锁用户#
下发删除锁用户蓝牙指令包,门锁本地清除该介质对应的独立开门权限;操作完成后调用对应模式删除上报接口清理云端记录,仅删除当前介质用户,不影响门锁其他开门用户。