乐橙云开发文档
快速入门
  • 文档综述
  • 云直播开发指南
  • 轻应用开发指南
  • 移动应用开发指南
  • 桌面应用开发指南
  • 消息推送
  • 云转存
  • 国标GB28181设备接入
  • HTTP接口
  • 服务支持
前往官网
快速入门
  • 文档综述
  • 云直播开发指南
  • 轻应用开发指南
  • 移动应用开发指南
  • 桌面应用开发指南
  • 消息推送
  • 云转存
  • 国标GB28181设备接入
  • HTTP接口
  • 服务支持
前往官网
快速入门
  • 文档综述

  • 云直播开发指南

  • 轻应用开发指南

  • 小程序对接指南

  • 移动应用开发指南

  • 桌面应用开发指南

  • 消息推送

  • 云转存

  • 国标GB28181设备接入

  • IOT物模型

  • HTTP接口

    • API隐私协议
    • 开发规范
    • Postman按接口模拟调用教程
    • accessToken:获取管理员token
    • 设备

      • 设备直播

      • 设备管理

        • 设备添加

          • 设备添加说明
          • 绑定设备
          • 解绑设备
        • 设备查询

        • 设备维护

      • 设备配置

      • 设备操作

      • 设备录像

      • 设备消息

      • 设备托管

      • 设备锁接入

    • 账户对接

    • 推送配置

    • 云存储服务

    • AI服务

    • AI智见服务

    • 设备能力集
    • 设备能力开关
    • 接口调用限制说明
    • 全局返回码说明
    • 云平台能力说明
    • 旧版本协议(后续不再维护)

  • 服务支持

本页目录
bindDevice:绑定设备
功能详情
请求地址
接口请求格式
传入参数说明
样例输入
返回data字段说明
样例输出

绑定设备

bindDevice:绑定设备

功能详情

将设备绑定在指定账号下。

请求地址

https://openapi.lechange.cn/openapi/bindDevice

接口请求格式

接口请求方式及部分鉴权参数如sign等计算方式,请参考开发规范

传入参数说明

参数名参数类型是否必填默认值合法值参数说明
tokenString是管理员accessToken
deviceIdString是设备序列号
codeString是code统称为设备验证码,针对不同的场景传的code值也会不一样,如下:
1、如果未修改过设备密码,则传设备底部标签中(或二维码中)8位数字的安全码;
2、如果修改了设备密码,则传修改后的设备密码;
3、如果未修改过设备密码,且该设备底部标签中(或二维码中)没有8位数字的安全码,则code值传空即可。
设备验证码或密码
encryptCodeString否加密后的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"
}
设备添加说明
解绑设备