1. 快速开始
Smart lock
中文
  • 中文
  • English
  • 快速开始
    • 密码开锁(仅离线)
    • 锁用户开锁
  • Cloud API
    • 考勤管理
      • 查询考勤配置
      • 查询考勤记录
      • 保存或更新考勤配置
    • 4G直连
      • 推送开锁记录
      • 4G开锁
      • 下发直连模块关联门锁指令
      • 上报直连模块关联结果
      • 检测直连模块状态
      • 4G下发密码
    • 发卡机相关接口(目前只在公寓实现,dlock暂未使用)
      • 绑定发卡机方法1
      • 绑定发卡机方法2
      • 删除发卡机
      • 删除在线卡片
      • 制作在线卡到门锁设备
      • 制作/清除 酒店公寓离线卡
      • 在线卡保存
      • 下发开始采集指纹数据指令
      • 下发终止采集指纹数据指令
      • 解绑发卡机
      • 同步下发指纹数据到门锁设备
      • 根据卡片所属人查询其所有卡片信息
    • 操作记录
      • 网关
        • 远程开锁(网关开锁)
        • 网关与服务端用户绑定
        • 下发网关关联门锁
        • 查询所有网关
        • 下发网关解绑门锁关联
        • 网关与服务端用户解绑
      • 获取当前用户操作记录
      • 删除操作记录
      • 门锁记录(无告警)
    • 门锁上报更新服务器
      • 门锁删除
      • 保存系统设置
      • 同步门锁记录(同步锁端未上报的记录)
      • 保存锁端用户
      • 保存门锁设置
      • 保存门锁记录,当前指令是0300调用保存
      • 上报门锁绑定0700
      • 4G模组关联上报
    • 锁相关接口
      • 查询当前用户所有锁
      • 查询当前锁详情信息
    • 密码相关
      • 查询当前用户所有密码
      • 限时密码(离线密码)
      • 单次密码(离线密码)
      • 永久密码(离线密码)
      • 清空密码(使用该密码开锁,所有密码都会失效)
      • 循环密码(离线密码)
      • 查询密码详情
      • 删除密码
      • 添加密码接口(密码生成完成后调用)
      • 修改密码
    • 指令相关(下发门锁)
      • 门锁绑定(公寓)
      • 门锁绑定(Dlock)
      • 添加锁用户
      • 修改锁用户
      • 删除锁用户
      • 读取门锁设置
      • 门锁初始化
      • 同步门锁用户
      • 同步门锁操作记录
      • 获取锁上报指令操作类型
      • 下发门锁设置
      • 下发4G模组关联
      • 下发门锁操作
    • 卡
      • 删除卡
      • 上报卡数据(添加卡)
      • 获取当前用户卡列表
      • 卡详情
      • 修改卡
    • 指纹
      • 删除指纹
      • 上报指纹数据(添加指纹)
      • 获取指定门锁的指纹用户列表
      • 指纹详情
      • 修改指纹
    • 遥控
      • 删除遥控
      • 上报遥控数据(添加遥控)
      • 获取当前遥控用户列表
      • 遥控详情
      • 修改遥控
    • 人脸
      • 删除人脸
      • 上报人脸数据(添加人脸)
      • 获取当前人脸用户列表
      • 人脸详情
      • 修改人脸
    • 掌纹
      • 删除掌纹
      • 上报掌纹数据(添加掌纹)
      • 获取当前掌纹用户列表
      • 掌纹详情
      • 修改掌纹
    • 登录相关
      • 登录
      • 验证码
      • 注册
    • 查询设备SN码
      GET
  • APP SDK V1
    • 微信小程序插件
  • 数据模型
    • 数据
    • 上报
    • 修改
    • 上报commonFormatData
    • 离线密码
    • 指令通用数据模型
    • 密码
  1. 快速开始

密码开锁(仅离线)

离线密码#

本文将对离线密码管理相关功能对接进行说明,包含离线密码生成、查询、新增、修改、删除、批量清空等接口能力。

1. 离线密码方案说明#

离线密码是通过服务端加密算法计算得到的一组密码值,不支持自定义密码数字,无法远程修改密码值。
离线密码支持有效期、周期、永久三种类型的密码,可以应对多种场景。
离线密码强制规则:有效期起始后,24 小时内必须下发门锁并使用一次;超过 24 小时未同步开门,密码自动失效。

2. 离线密码完整新增流程(必看)#

调用对应类型生成接口(永久 / 单次 / 限时 / 循环 / 清空密码 ),由服务端算法算出离线密码;
必须调用添加密码,将生成的离线密码信息上报云端入库,用于平台统一列表管理、状态统计;
注意:只调用生成接口不执行添加密码接口,云端无该条密码记录,查询列表无法展示该密码。

3. 查询密码#

系统提供两类查询接口,用于前端页面数据渲染:
查询当前用户所有密码查询当前用户所有密码
分页拉取当前账号名下门锁全部密码(离线密码以及自定义密码),返回密码类型、有效期、门锁设备、使用状态等基础信息。
查询密码详情
传入密码唯一 ID,获取单条离线密码完整配置,包含密码值、生效时段、循环规则等。

4. 修改密码#

修改密码仅支持修改密码备注名称,密码明文数值、有效期时效、循环周期配置均不支持修改。
若需要变更密码数字或调整使用时效,只能删除原有云端记录,重新生成一套全新离线密码。

5. 删除 & 清空密码(重要区分)#

删除密码
仅删除云端存储的密码记录,无法同步清除门锁本地存储的离线密码,门锁仍可使用该密码开门,仅前端列表不再展示该条密码。
清空密码
在门锁键盘输入该清空密码后,会清除生成本条清空码之前所有已创建的离线密码;清空操作完成后,本次操作之后新生成的离线密码不受影响。单台门锁 1 小时内仅能生成唯一一组清空密码。
下一页
锁用户开锁
Built with