乐橙云开发文档
控制台
更新日志
控制台
更新日志
快速入门
  • 开始使用
  • 核心概念
  • 开发指南
    • 账号与授权
    • 设备接入
      • 在控制台或乐橙 App 添加设备
      • 通过接口绑定设备
      • 在 App 内配网并绑定
      • 接入国标 GB28181 设备
      • 国标设备厂商配置
      • 查询、改名与解绑设备
      • 升级设备固件
      • 排障:绑定失败、设备离线
    • 音视频
    • 控制与配置设备
    • 接收设备事件
    • 云存储
    • AI分析
    • 门锁与门铃
    • 上线与排障
  • 设备能力与事件参考
  • API 参考
  • SDK 与工具
  • 行业方案
  • 平台与支持
本页目录
本页目标
步骤
各端实现
相关参考

通过接口绑定设备

通过接口绑定设备

本页目标

在服务端调用 bindDevice,把已知序列号的设备绑定到当前开发者账号(需管理员 accessToken)。

把设备绑定到指定账号下,调用 bindDevice:绑定设备。添加设备 的方式三指向该接口。

绑定/解绑接口见 设备添加说明(bindDevice / unBindDevice)。

前提:管理员 accessToken,见 首次接口调用 与 token。

步骤

  1. 准备设备序列号,以及验证码或密码。bindDevice 的参数表、请求示例在 绑定设备,字段以各 OpenAPI 方法页为准。code 的说明是:

    • 如果未修改过设备密码,则传设备底部标签中(或二维码中)8 位数字的安全码。
    • 如果修改了设备密码,则传修改后的设备密码。
    • 如果未修改过设备密码,且该设备底部标签中(或二维码中)没有 8 位数字的安全码,则 code 传空。

    encryptCode / encryptCodeV2 非必填。明文 code 与密文互斥;若同时传 encryptCode 与 encryptCodeV2,优先按 v2 解密(字段表见 绑定设备)。

  2. 调用 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 配网绑定,见 应用开发「设备绑定」。

相关参考

  • 设备添加说明
  • bindDevice:绑定设备
  • 应用开发
  • 接入指南
  • 查询、改名与解绑设备
  • 排障:绑定失败、设备离线

商务合作:cloud_openteam@imou.com · 工单 · 获取帮助(公众号、小程序试用中心)

Copyright © 2015-2026 IMOU. All Rights Reserved. 浙ICP备16023676号

在控制台或乐橙 App 添加设备
在 App 内配网并绑定