商业门锁 SDK

商业门锁 App SDK 提供一套完整的门锁管理解决方案，旨在帮助您轻松集成商业门锁功能到移动应用中，帮助您快速创建安全可靠的门锁控制应用，为用户提供便捷的门锁管理解决方案。

方案优势

• 低成本的即开即用方案
• 丰富的物联能力
• 快速增长的强大生态系统
• 可持续的增值服务
• 数字化全球项目运营管理
• 金融级网络数据安全

SDK 功能概述

• 门锁配网：提供专业且高效的配网能力，帮助提高门锁配网效率。
• 门锁控制：允许用户通过多种方式，方便快捷地开启不同协议的门锁。
• 密码管理：支持一次性密码、永久密码、限时离线密码和限时在线密码等多种密码方式，满足不同场景的需要。
• 电子钥匙管理：支持配置不同角色拥有不同的电子钥匙权限，轻松管理不同功能的门锁。
• 日志管理：记录每次开锁的时间、方式以及开锁者的信息。当门锁遇到异常情况时，例如多次尝试失败、电池电量低等，提供通知能力。
• 设备管理及 OTA 升级：实时查看门锁的电量和信号强度等状态信息，支持远程更新门锁的软件或配置参数。
• 安全性：SDK 内置了高级的加密和安全协议，保障用户数据的安全性和隐私保护，防止未经授权的访问和数据泄露。

名词解释

站点

站点是指挂载在某一账号下的、可独立操作的 单元，门锁等设备必须要挂载在某一站点下才可进行操作。
一个账号下可以有不定数量的站点。新注册账号默认没有站点，需创建站点后，基于站点再进行门锁等设备的配网。

电子钥匙

电子钥匙可以理解为是将某个门锁类设备按照一定规则授权给另外一个账号，被授权的账号登录到 App，即可查看已经授权的门锁类设备。电子钥匙被管理员移除后，被授权的账号下将无法获取到之前已授权的门锁。

电子钥匙共有 3 种类型：

• 限时电子钥匙：在生效周期和时间区间内可以正常使用。
• 永久电子钥匙：永久可用，不限生效周期和时间区间。
• 单次电子钥匙：仅可使用一次。

密码

密码是指可以直接在门锁类实体上输入的开锁密码。密码按照创建时对设备在线状态的要求，分为在线密码和离线密码。

在线密码

在线密码：需要设备在线（例如蓝牙在线、网关在线等）的情况下创建的密码，密码会直接写入到门锁类设备中。同理，已经创建的在线密码在移除时也要求设备必须在线，否则写入到门锁设备的密码将无法正常清除。

在线密码有两种类型：

• 永久密码：可以永久使用的密码。
• 限时密码：在生效周期、循环周期和时间区间内可正常使用的密码。

离线密码

离线密码：不需要设备在线即可创建和使用的密码。同理，离线密码的移除也无需设备在线。

离线密码有两种类型：

• 限时离线密码：在生效周期内均可使用。限时离线密码在移除后，需要在门锁设备上手动输入清除码，否则，被删除的限时离线密码将可以继续使用。
• 单次密码：仅可使用一次，且必须在创建完成之后的 6 个小时内使用。

接入流程图