第三方授权
本文档介绍智能门锁与第三方平台(如锁通通、涂鸦智能)的授权对接协议。
功能概述
第三方授权模块支持将门锁与第三方 IoT 平台对接:
| 功能 | 指令码 | 说明 |
|---|---|---|
| 读取注册密钥 | 0x30A7 | 获取门锁的注册密钥 |
| 发送授权码 | 0x30A6 | 向门锁发送第三方平台授权信息 |
授权流程
读取注册密钥
指令码: 0x30A7
方向: APP → 门锁
加密: SM4 私钥模式
请求消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| LockID | 字符串 | 40 | 锁 ID |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | AuthCode 数据长度 |
| AuthCode | 字符串 | 变长 | 鉴权码,长度由 AuthCodeLen 指示 |
应答消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |
| RegisterKey | 字符串 | 40 | 注册密钥 |
发送授权码
指令码: 0x30A6
方向: APP → 门锁
加密: SM4 私钥模式
请求消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| LockID | 字符串 | 40 | 锁 ID |
| UUID | 字符串 | 40 | 第三方平台分配的 UUID |
| Key | 字符串 | 40 | 第三方平台分配的 Key |
| Mac | 字符串 | 40 | 第三方平台分配的 Mac |
| Platform | 整型 | 1 | 平台类型 |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | AuthCode 数据长度 |
| AuthCode | 字符串 | 变长 | 鉴权码,长度由 AuthCodeLen 指示 |
Platform 平台类型
| 值 | 平台 |
|---|---|
| 0 | 锁通通 |
| 1 | 涂鸦智能 |
应答消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令 ID |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |
指令汇总
| 指令码 | 名称 | 方向 | 说明 |
|---|---|---|---|
| 0x30A7 | 读取注册密钥 | APP → 门锁 | 获取设备注册密钥 |
| 0x30A6 | 发送授权码 | APP → 门锁 | 发送第三方平台授权信息 |
