Skip to content

如何开始对接 ​

请阅读该文档了解开放平台(如什么是开发者账号,是否收费等)、对接流程(通通锁App对接,伴云来(原通通酒店)),小程序插件,API, SDK, 常见问答等。

App对接/开发 ​

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

API ​

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

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

  • 密码开锁:支持限期密码,单次密码,自定义密码(自定义密码要求设备在线,即锁连接了网关 或 锁是WiFi锁)等多种密码类型;

  • 蓝牙开锁:也称为电子钥匙(eKey), 收到电子钥匙的用户可以用手机蓝牙进行开锁,一般需要下载App;

  • 远程开锁:需要设备联网(锁连接了网关 或者 WiFi锁),可以调用云端API进行远程开锁/闭锁等;

  • IC卡开锁:蓝牙录入IC卡 或者 调用API远程下发IC卡,通过IC卡片进行开锁;

  • 指纹开锁:通过录入指纹进行开锁;

  • 人脸识别:通过录入人脸 或 下发人脸照片进行开锁;

  • 开锁记录:上传、获取开锁记录,或回调通知;

SDK ​

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

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

小程序插件 ​

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

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

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

如果希望:

  • 所有数据都存放在第三方软件自己的服务器上。
  • 密码和电子钥匙也是通过第三方软件自己的服务器生成。
  • 所有操作都不需要经过通通锁服务器,所有的数据都不存放在通通锁服务器。
  • 网关、API都连接本地服务器,实现内网需求。

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

常见问答 ​

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

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