如何开始对接

请阅读该文档了解开放平台、对接流程(通通锁App对接,伴云来(原通通酒店)),小程序插件,API, SDK, 常见问答等。

注意:关于对接,我们不提供测试账号或沙箱环境,对接直接参考对应的对接流程即可

一、开发者账号和应用

1.1、注册开发者账号

1.2、开发者账户中创建应用并申请,审核通过会获取client id & secret

二、对接通通锁App

2.1、在通通锁APP里添加锁

2.2、获取通通锁App账户的访问令牌

注意accessToken会在expires_in标识的时间后失效,默认为90天,失效后需要重新获取或刷新

2.3、获取accessToken之后,可以用其调用其他API

三、伴云来(原通通酒店)对接

伴云来(原通通酒店)对接不需要开放平台注册开发者账户以及申请应用,可以直接去伴云来(原通通酒店)电脑客户端--设置--门锁对接(第一次需先申请对接)--获取对接信息

对接信息包含client_id, client_secret, 账户信息和密码,用对接信息直接调用API即可,详细图文步骤请参考链接:伴云来(原通通酒店)对接、发卡器对接

通通酒店App使用手册:介绍 | 通通酒店帮助中心

四、API

提供锁、密码、电子钥匙、IC卡、指纹、网关等接口,具体接口文档请参考开放平台 Cloud API v3 部分;

开放平台不仅仅只包含了下面介绍的API,其他API可以自行探索开放平台文档Cloud API v3 部分

五、SDK

SDK只是进行蓝牙离线操作;如果需要数据同步至云端,在调用SDK方法之后,需调用章节四中对应的API进行同步

如不需要云端同步(只想蓝牙离线控制),可以不调用非必须的API

六、小程序插件

小程序插件只是进行蓝牙离线操作;如果需要数据同步至云端,在调用SDK方法之后,需调用章节四中对应的API进行同步

如不需要云端同步(只想蓝牙离线控制),可以不调用非必须的API

七、私有化(本地化)部署(需付费)

如果希望:

可以进行本地化部署,请参考文档:本地化部署

八、常见问答

汇总了对接过程中常见的问题,如锁、开放平台、API对接、密码、网关和WIFI锁、发卡器发卡以及回调地址相关问题。

具体请参考链接:常见问答