离线密码#
本文将对离线密码管理相关功能对接进行说明,包含离线密码生成、查询、新增、修改、删除、批量清空等接口能力。1. 离线密码方案说明#
离线密码是通过服务端加密算法计算得到的一组密码值,不支持自定义密码数字,无法远程修改密码值。离线密码支持有效期、周期、永久三种类型的密码,可以应对多种场景。离线密码强制规则:有效期起始后,24 小时内必须下发门锁并使用一次;超过 24 小时未同步开门,密码自动失效。2. 离线密码完整新增流程(必看)#
调用对应类型生成接口(永久 / 单次 / 限时 / 循环 / 清空密码 ),由服务端算法算出离线密码;
必须调用添加密码,将生成的离线密码信息上报云端入库,用于平台统一列表管理、状态统计;
注意:只调用生成接口不执行添加密码接口,云 端无该条密码记录,查询列表无法展示该密码。3. 查询密码#
系统提供两类查询接口,用于前端页面数据渲染:
查询当前用户所有密码查询当前用户所有密码
分页拉取当前账号名下门锁全部密码(离线密码以及自定义密码),返回密码类型、有效期、门锁设备、使用状态等基础信息。
查询密码详情
传入密码唯一 ID,获取单条离线密码完整配置,包含密码值、生效时段、循环规则等。4. 修改密码#
修改密码仅支持修改密码备注名称,密码明文数值、有效期时效、循环周期配置均不支持修改。
若需要变更密码数字或调整使用时效,只能删除原有云端记录,重新生成一套全新离线密码。5. 删除 & 清空密码(重要区分)#
删除密码
仅删除云端存储的密码记录,无法同步清除门锁本地存储的离线密码,门锁仍可使用该密码开门,仅前端列表不再展示该条密码。
清空密码
在门锁键盘输入该清空密码后,会清除生成本条清空码之前所有已创建的离线密码;清空操作完成后,本次操作之后新生成的离线密码不受影响。单台门锁 1 小时内仅能生成唯一一组清空密码。