【涂鸦物联网足迹】涂鸦云平台接口列表—智能门锁

一、智能门锁整体介绍：

智能门锁区别于传统机械锁，在用户安全性、识别、管理性方面更加智能化简便化的锁具。智能门锁使用的是非机械钥匙作为用户识别ID的，比如指纹锁、虹膜识别等等，甚至还可以直接通过手机App或者小程序进行远程开门。

本文介绍了使用云开发平台进行智能门锁的开发的相关流程和 API。智能门锁云开发对接类型主要针对客户自建服务器实现门锁相关业务，包括但不限于 微信小程序、 Web 系统、H5应用。

二、对接流程

在对接门锁垂直品类业务前，需要注册成为涂鸦云开发平台开发者，相关详情请参考 涂鸦云开发平台-快速入门。

涂鸦智能门锁云开发对接流程如下图所示：

三、适用品类

四、接口日志

涂鸦可提供以当前时间计，最近7天以内的接口调用日志查询，开发者可提供接口请求参数，在开发者平台以工单的形式提交，涂鸦工作人员会尽快处理，工单处理时间，一般在两小时以内做出答复，如紧急问题，可通过线下渠道找项目经理加速处理。

五、密码创建流程

1. Wi-Fi门锁处理流程：

2. Zigbee门锁处理流程：

• Zigbee门锁正常业务流程

1. 调用方调用API创建密码
2. 涂鸦云平台下发密码给网关
3. 网关下发密码给门锁
4. 门锁响应密码状态：配置成功
5. 网关上报密码状态：配置成功
6. 涂鸦云平台存储更新密码状态：配置成功
7. 调用方轮询密码状态，直至密码状态更新为：配置成功/配置失败，轮询超时间为25s

• Zigbee门锁异常业务流程

1. 调用方调用API获取门锁信息
2. 调用方调用API创建密码（使用门锁localkey加密）
3. 涂鸦云平台下发密码给网关
4. 网关下发密码给门锁
5. 门锁未响应状态
6. 网关重试下发密码，重试3次结束
7. 网关上报密码状态：配置失败
8. 涂鸦云平台存储更新密码状态：配置失败
9. 调用方轮询密码状态，直至密码状态更新为：配置成功/配置失败，轮询超时时间为25s

六、密码加密流程

七、门锁 API

• 获取密码加密的临时秘钥
• 创建临时密码
• 创建无名称的临时密码
• 同步密码
• 获取临时密码信息/列表
• 修改/冻结/解冻/删除/临时密码
• 获取动态密码
• 获取离线临时密码
• 查询开门记录
• 设备成员管理
• 新增/修改/删除设备成员
• 查询设备成员信息
• 根据设备ID查询成员信息列表
• 分配门锁密码给设备成员

八、门锁解锁方式API

• 获取门锁成员未/已绑定的解锁方式列表
• 门锁解锁方式录入/删除
• 取消录入解锁凡是
• 设置解锁方式为挟持解锁
• 门锁通用能力下发控制
• 门锁解锁方式录入结果推送