1.7.1. 设备二维码使用说明
1.7.1.1. 概述
设备二维码,用于在设备未被绑定时,在设备屏幕显示二维码,用户可使用第三方APP直接扫二维码添加设备。
1.7.1.2. 二维码内容
二维码内容,将明文JSON数据格式,经过Base64加密处理。完整JSON数据格式如下:
Key | 必填 | 描述 |
---|---|---|
sn | Y | 设备序列号 |
key | Y | 安全码,对应设备固件参数SecuKey安全码 |
reset | N | 设备是否已重置,1代表已重置,0代表未重置;不填,默认0 |
ver | N | 二维码内容版本号,不同版本json内容不一样,默认1.0.0 |
样例:
{
"sn": "6192202300014",
"key": "SED1T9ED",
"reset":1
}
Base64加密后:
ew0KICAgICJzbiI6ICI2MTkyMjAyMzAwMDE0IiwNCiAgICAia2V5IjogIlNFRDFUOUVEIiwNCiAgICAicmVzZXQiOjENCn0=
1.7.1.3. 使用步骤
第1步:
APP扫描设备二维码后,通过Base64解密获取明文JSON数据,解析JSON二维码,根据数据格式规范,验证数据合法性;如果不合法,给出非法二维码提示信息,流程结束。
第2步:
若 reset=1
reset=1表示设备有手动重置过,此时设备端数据已清空但服务端可能保存着该设备的数据;需要先调用删除设备的接口,如果调用结果返回删除设备失败,则提示具体的失败原因,流程结束;如果删除设备成功,则继续调用添加设备接口,完成设备添加。
若 reset=0或不存在
调用添加设备接口,完成设备添加。