网关相关接口对接指南

科技侠智能门锁本身不联网，只能通过蓝牙连接与外界通迅，网关是一个可以联网的小设备，使远程管理智能锁成为可能。

网关添加好后会自动搜索其附近的锁，如果搜索到的锁和网关属于同一个管理员账号，网关服务器会保存网关和锁之间的连接关系，锁和网关是多对多的关系，允许一个网关连接多个锁，锁也可以连接多个网关，没有数量限制，后续用户想远程操作锁，系统会自动选择蓝牙连接信号强度最好的网关下发操作指令。

开发者可以先使用科技侠APP添加网关，G2网关请参考说明文档：G2网关添加说明。

也可以自己开发APP集成我们的APP SDK来实现网关的初始化，具体参考APP SDK网关接口示例，初始化网关时需要传用户主键ID和密码以标识网关归属的用户，其中的用户主键ID在获取访问令牌时会返回，也可以通过云端获取用户主键ID接口获取。

（1）APP SDK完成网关的初始化配置，如果配置的网络正确，网关会自动连接网关服务器，完成在云端的初始化。

（2）调用云端查询某网关是否初始化成功接口确认网关已经成功在云端完成初始化，初始化成功会返回gatewayId。

（3）调用云端上传网关信息接口上传网关的固件版本信息和网络名称，方便后续网关固件升级和维护。

网关添加成功后，可以通过获取名下网关列表接口查询到。

不需要用户去手动关联。

网关初始化完成即会自动搜索附近的锁，如果搜索到的锁和网关属于同一个管理员账号，就会自动关联上，所以请确保锁和网关是用同一个账号添加的。

可以通过获取网关管理的锁列表和获取锁连接的网关列表两个接口查询锁和网关之间的关联关系和信号强度。

当向锁发起远程操作时，系统会选择信号强度最好的网关下发操作指令。

锁连接上网关后，很多锁管理工作就不需要再到锁边上通过蓝牙连接来执行了，可以通过网关远程下发指令给锁，如开锁、闭锁，查询锁的开关状态，管理（增、删除、改）密码，管理IC卡，管理指纹，查询锁电量、查询和校准锁时间等。

锁连接上网关后，不再需要到锁边上去读取操作记录，开锁记录也会自动通过网关准实时（一般几秒钟内）的上传到云端，在科技侠APP上的锁管理员会收到开锁的推送消息，开放平台也支持将记录实时推送给开发者,参考文档：锁记录回调通知

通过网关执行远程操作，网关需要和锁之间建立蓝牙连接通讯，这个过程一般需要几秒钟时间，网关和锁之间的蓝牙连接信号强度越弱，耗时会越长，甚至有失败的可能性。通讯过程中蓝牙连接被打断（如触碰到面板等）也会导致耗时增加甚至操作失败。

网关远程操作请求时间可能会很长，云端设置的超时时间是30秒，建议开发者调用远程指令下发相关接口的请求也设置30秒的超时时间。有些开发者设置10秒超时，会有可能收不到请求反馈判定请求失败，但指令已经下发成功。

网关和锁同一时间都只能建立一个蓝牙连接，网关只能串行执行远程操作指令，如果网关当前正在执行远程操作，再用该网关发起远程操作则会直接返回失败。