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

  • 云直播开发指南

  • 轻应用开发指南

  • 小程序对接指南

  • 移动应用开发指南

  • 桌面应用开发指南

  • 消息推送

  • 云转存

  • 国标GB28181设备接入

  • IOT物模型

  • HTTP接口

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

    • 账户对接

    • 推送配置

    • 云存储服务

    • AI服务

    • AI智见服务

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

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

  • 平台活动

本页目录
deviceList:获取设备列表
功能详情
请求地址
传入参数说明
样例输入
返回data字段说明
样例输出

获取设备列表

deviceList:获取设备列表

功能详情

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

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

请求地址

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

传入参数说明

参数名参数类型是否必填默认值合法值参数说明
tokenString是管理员accessToken
queryRangeString是数字取值范围为:[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"
    }
}

返回data字段说明

字段名字段类型字段说明
countInteger本次查询返回的设备总数
devicesdeviceIdString设备序列号
channelNumInteger设备通道数
baselineString设备基线类型
versionString设备软件版本号
encryptModeInteger设备加密模式:0-设备默认加密 1-用户自定义加密
appIdString设备当前绑定的开发者信息,若为乐橙app绑定则返回空字符串
deviceCatalogString设备大类(NVR/DVR/HCVR/IPC/SD/IHG/ARC)
nameString设备名称
deviceModelString设备型号
abilityString设备能力集
canBeUpgradeBoolean设备软件程序是否有新版本可以升级
brandString设备品牌信息:lechange-乐橙设备,general-通用设备
platFormInteger设备接入平台编号:3-非pass设备,4-pass设备
statusInteger设备当前状态:0-离线,1-在线,3-升级中
channelschannelNameString设备通道名称
channelOnlineBoolean设备通道在线状态:true-在线,false-离线
channelAbilityString设备通道能力集,单通道设备请以设备能力集为准
channelIdInteger设备通道号
channelPicUrlString设备通道封面图,新设备可能不存在封面图,可上传设备通道封面图或者刷新设备封面图
csStatusInteger云存储套餐状态:-1-未开通 0-已失效 1-套餐生效中
alarmStatusInteger报警布撤防状态,0-撤防,1-布防,accessType=PaaS的需要通过bindDeviceInfo接口获取最新值
shareStatusBoolean设备通道分享状态: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"
}
云平台控制
单个设备信息获取