通过接口绑定设备
通过接口绑定设备
本页目标
在服务端调用 bindDevice,把已知序列号的设备绑定到当前开发者账号(需管理员 accessToken)。
把设备绑定到指定账号下,调用 bindDevice:绑定设备。添加设备 的方式三指向该接口。
绑定/解绑接口见 设备添加说明(bindDevice / unBindDevice)。
前提:管理员 accessToken,见 首次接口调用 与 token。
步骤
准备设备序列号,以及验证码或密码。bindDevice 的参数表、请求示例在 绑定设备,字段以各 OpenAPI 方法页为准。
code的说明是:- 如果未修改过设备密码,则传设备底部标签中(或二维码中)8 位数字的安全码。
- 如果修改了设备密码,则传修改后的设备密码。
- 如果未修改过设备密码,且该设备底部标签中(或二维码中)没有 8 位数字的安全码,则
code传空。
encryptCode/encryptCodeV2非必填。明文code与密文互斥;若同时传encryptCode与encryptCodeV2,优先按 v2 解密(字段表见 绑定设备)。调用 bindDevice。将设备绑定在指定账号下。返回无
data体,成功时result.code为0。
最小请求体示例(sign/time/nonce 见 调用约定):
{
"system": { "ver": "1.0", "appId": "<appId>", "sign": "<sign>", "time": 1603352833, "nonce": "<uuid>" },
"id": "<uuid>",
"params": { "token": "<accessToken>", "deviceId": "<deviceId>", "code": "<code>" }
}
新出厂设备的限制,按 应用开发:后续新出厂的设备(或者老设备升级成新程序),将可能存在无法直接通过调用 HTTP 接口(bindDevice)完成设备绑定操作,开发者需要结合客户端 SDK 完成绑定操作。并且,设备绑定涉及多个过程,根据不同的设备版本,绑定的流程也不同。客户端 SDK DEMO 中有编码描述,该页用一张流程图概括,没有逐步文字。流程图见 应用开发「2.设备绑定」。
各端实现
服务端 HTTP
绑定请求由后台调用 bindDevice:绑定设备。请求地址为 https://openapi.lechange.cn/openapi/bindDevice。参数名、类型、是否必填和加密公式以该页为准。
新出厂或新固件设备可能无法仅用 HTTP bindDevice,需配合客户端 SDK 配网绑定,见 应用开发「设备绑定」。