绑定设备
bindDevice:绑定设备
功能详情
将设备绑定在指定账号下。
请求地址
https://openapi.lechange.cn/openapi/bindDevice
接口请求格式
接口请求方式及部分鉴权参数如sign等计算方式,请参考开发规范
传入参数说明
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员accessToken | ||
| deviceId | String | 是 | 设备序列号 | ||
| code | String | 是 | code统称为设备验证码,针对不同的场景传的code值也会不一样,如下: 1、如果未修改过设备密码,则传设备底部标签中(或二维码中)8位数字的安全码; 2、如果修改了设备密码,则传修改后的设备密码; 3、如果未修改过设备密码,且该设备底部标签中(或二维码中)没有8位数字的安全码,则code值传空即可。 | 设备验证码或密码 | |
| encryptCode | String | 否 | 加密后的code值,非必填。code参数或encryptCode参数可选其一使用,若两者都传以code为准。 如果业务对安全有较高需求,可使用encryptCode参数,加密规则如下。 | 加密后的设备验证码或密码 |
password计算值的公式为:encryptCode = Base64(AES256_CBC(code,key[],iv[])); 详细规则如下: 1、采用CBC分组加密的方式,算法为AES/CBC/PKCS5Padding; 2、code为设备的明文验证码或密码; 3、key[]为密匙(key)的二进制数组; 4、密匙(key)为:LowerCase(MD5(UpperCase(Base64(KDF(deviceId,MD5(appsecret)))))),KDF算法为PBKDF2WithHmacSHA256,迭代1200次,导出秘钥长度256; 5、iv[]为初始化向量的二进制数组,为:MD5(appSecret),采用Java自带的MessageDigest的MD5算法加密。
加密示例: deviceId是TESTQWERXXXX,appsecret是12345qwert67890asdfg12345qwert,原code是Admin123,计算后得到encryptCode为5ZtW6b0Ttf1zOiFhqynKaA==
样例输入
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign":"69832b9ae3efe459bda3a0aaf0cc4a10",
"time":1603352833,
"nonce":"b52eb20c-c836-45d7-9a98-cded3cf2fa9b"
},
"id":"5d5c16ec-0ee4-4880-88dd-6ce602d1e138",
"params":{
"token":"At_00000ad9e6e87f0142eb92e207aec46a",
"deviceId":"TESTQWERXXXX",
"code":"Admin123"
}
}
返回data字段说明
无data数据返回
样例输出
{
"result":{
"msg":"操作成功。",
"code":"0"
},
"id":"5d5c16ec-0ee4-4880-88dd-6ce602d1e138"
}