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

  • 云直播开发指南

  • 轻应用开发指南

  • 小程序对接指南

  • 移动应用开发指南

  • 桌面应用开发指南

  • 消息推送

  • 云转存

  • 国标GB28181设备接入

  • IOT物模型

  • HTTP接口

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

    • 账户对接

    • 推送配置

    • 云存储服务

    • AI服务

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

      • 旧版协议说明
      • 云平台控制
      • 获取设备列表
        • deviceList:获取设备列表
          • 功能详情
          • 请求地址
          • 传入参数说明
          • 样例输入
          • 返回data字段说明
          • 样例输出
      • 单个设备信息获取
      • 根据设备序列号获取多个设备信息
      • 单个设备通道的详细信息获取
      • 获取设备版本和可升级信息
      • 分页获取开放平台添加设备的通道基本信息
      • 获取开放平台添加设备的通道基本信息
      • 批量获取设备的详细信息
      • 分页获取乐橙app添加或分享的设备通道基本信息
      • 获取乐橙app添加或分享设备的通道基本信息
      • 批量获取乐橙app添加或分享的设备详细信息
      • 分页获取乐橙app分享给开发者设备列表
      • 批量获取多个设备通道以及配件的能力集
      • 获取子账号下指定的授权设备详细信息
      • 分页获取子账号下授权设备的详细信息
      • 获取呼吸灯状态
      • 设置呼吸灯开关
      • 设置设备本地录像计划
  • 服务支持

本页目录

获取设备列表

# deviceList:获取设备列表

# 功能详情

分页获取开发者账号下有权限的设备详细信息列表。

注意:使用accessToken获取设备列表时,会同时抽取通过乐橙APP绑定的设备。

# 请求地址

https://openapi.lechange.cn/openapi/deviceList

# 传入参数说明

参数名 参数类型 是否必填 默认值 合法值 参数说明
token String 是 管理员accessToken
queryRange String 是 数字取值范围为:[1,N](N为正整数,且后者>前者); 差值取值范围为:[0, 99] 第几条到第几条

# 样例输入

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"d295752a8e075c9faf6ac356f01fe0e9",
        "time":1599028453,
        "nonce":"e2ab3938-971c-4791-893a-84a6c6a4fa9e"
    },
    "id":"e606cff7-6161-46b1-a8dd-543f84dd2809",
    "params":{
        "token":"At_00006ac6e32d123141238f60147de7ec",
        "queryRange":"1-10"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 返回data字段说明

字段名 字段类型 字段说明
count Integer 本次查询返回的设备总数
devices deviceId String 设备序列号
channelNum Integer 设备通道数
baseline String 设备基线类型
version String 设备软件版本号
encryptMode Integer 设备加密模式:0-设备默认加密 1-用户自定义加密
appId String 设备当前绑定的开发者信息,若为乐橙app绑定则返回空字符串
deviceCatalog String 设备大类(NVR/DVR/HCVR/IPC/SD/IHG/ARC)
name String 设备名称
deviceModel String 设备型号
ability String 设备能力集
canBeUpgrade Boolean 设备软件程序是否有新版本可以升级
brand String 设备品牌信息:lechange-乐橙设备,general-通用设备
platForm Integer 设备接入平台编号:3-非pass设备,4-pass设备
status Integer 设备当前状态:0-离线,1-在线,3-升级中
channels channelName String 设备通道名称
channelOnline Boolean 设备通道在线状态:true-在线,false-离线
channelAbility String 设备通道能力集,单通道设备请以设备能力集为准
channelId Integer 设备通道号
channelPicUrl String 设备通道封面图,新设备可能不存在封面图,可上传设备通道封面图或者刷新设备封面图
csStatus Integer 云存储套餐状态:-1-未开通 0-已失效 1-套餐生效中
alarmStatus Integer 报警布撤防状态,0-撤防,1-布防,accessType=PaaS的需要通过bindDeviceInfo接口获取最新值
shareStatus Boolean 设备通道分享状态:true-设备通道已分享给其他用户,false-设备通道未分享给其他用户

# 样例输出

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "devices":[
                {
                    "channelNum":1,
                    "baseline":"ARC",
                    "deviceId":"TESTQWERXXXX",
                    "version":"2.145.1000.0.R.20181112",
                    "channels":[
                        {
                            "csStatus":-1,
                            "alarmStatus":0,
                            "channelName":"TP1S-1375",
                            "channelOnline":true,
                            "channelAbility":"PTZ,MDW,MDS,ChnLocalStorage",
                            "channelId":0,
                            "channelPicUrl":"",
                            "shareStatus":false
                        }
                    ],
                    "encryptMode":0,
                    "appId":"lcdxxxxxxxxx",
                    "deviceCatalog":"ARC",
                    "name":"TP1S-1375",
                    "deviceModel":"TP1S",
                    "ability":"WLAN,Auth,BreathingLight,CloudStorage,LocalStorage,PlaybackByFilename,MT,AGW,SLAlarm,CK,RD,LocalRecord,XUpgrade,TimeSync,ModifyPassword,LocalStorageEnable,RemoteControl,PTZ,Panorama,FrameReverse,AudioEncode,AudioEncodeControl,AlarmMD,MDW,MDS,AudioTalk,AlarmSound",
                    "canBeUpgrade":false,
                    "brand":"lechange",
                    "platForm":4,
                    "status":1
                }
            ],
            "count":1
        }
    },
    "id":"e606cff7-6161-46b1-a8dd-543f84dd2809"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
云平台控制
单个设备信息获取
意见反馈
您的改进建议

鼠标选中内容,快速反馈问题

选中存在疑惑的内容,即可快速反馈问题,我们将尽快跟进处理。

不再提示 好的,我知道了

企业微信
企业微信二维码

扫码添加企业微信

在线沟通乐橙云对接方案及费用问题

  • 浅色模式
  • 深色模式
  • 阅读模式
您的改进建议
商务咨询