APP集成开发指南
1.1 概述
通通锁是一款拥有完全自主知识产权的软硬件结合的门锁产品,通过手机 APP替代传统的钥匙实现开门。
针对合作伙伴系统定制的需求,通通锁提供了开放平台 Open API 和 APP SDK。合作伙 伴可方便地在自己的应用系统和 APP中集成通通锁的各项功能。 本文档对 APP的集成开发进行说明。
1.2 应用架构
系统应用架构如下图所示。
APP借助SDK通过蓝牙与锁通信,实现锁的初始化、开锁、读取锁操作记录等; 建议APP不直接调用开放平台的Open API,由APP后台应用系统与Open API交互,并暴露相应的接口给APP。 应用系统通过通通锁开放平台提供的 Open API 与平台实现用户绑定和授权,并进行门锁、电子钥匙以及键盘密码等的管理。
1.3 开发步骤
(1)注册开发者账号并创建应用,得到client_id和client_secret。 (2)APP里导入APP SDK开发包,调用其中的方法,并实现相应的回调方法。 (3)APP后台服务端应用系统通过Open API获取访问令牌。 (4)携带访问令牌,就可以调用Open API的锁、钥匙、密码相关接口,具体的请参考后续应用流程。
1.4 应用流程
系统涉及的主要流程包括:初始化门锁,电子钥匙开锁
1.4.1 绑定门锁
管理员使用APP实现对门锁的初始化设置,并通过应用系统将门锁信息传给开放平台。 应用系统可以对房间和门锁进行关联。
1.4.2 电子钥匙发放及开锁
应用系统向用户发送带有时效的电子钥匙。 用户使用APP从服务端同步获取钥匙,并进行开门。
