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從服務端同步獲取鑰匙，並進行開門。