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

  • 云直播开发指南

  • 轻应用开发指南

  • 小程序对接指南

  • 移动应用开发指南

  • 桌面应用开发指南

  • 消息推送

  • 云转存

  • 国标GB28181设备接入

  • IOT物模型

  • HTTP接口

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

      • 设备直播

      • 设备管理

        • 设备添加

        • 设备查询

          • 设备查询说明
          • 批量查询设备详细信息
          • 分页查询设备详细信息
          • 获取设备在线状态
          • 未绑定设备信息获取
          • 查询设备绑定情况
          • 获取设备升级状态和进度
        • 设备维护

      • 设备配置

      • 设备操作

      • 设备录像

      • 设备消息

      • 设备托管

      • 设备锁接入

    • 账户对接

    • 推送配置

    • 云存储服务

    • AI服务

    • AI智见服务

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

  • 服务支持

本页目录
listDeviceDetailsByPage:分页查询设备详细信息
功能详情
请求地址
接口请求格式
传入参数说明
样例输入
返回data字段说明
样例输出

分页查询设备详细信息

listDeviceDetailsByPage:分页查询设备详细信息

功能详情

分页获取账号下设备通道的基本信息。

请求地址

https://openapi.lechange.cn/openapi/listDeviceDetailsByPage

接口请求格式

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

传入参数说明

参数名参数类型是否必填默认值合法值参数说明
pageSizeint是每页条目数,范围:1~50
pagelong是查询页码,从1开始
tokenString是管理员或者子账户accessToken
sourcestringbindAndSharebind:获取绑定的设备
share:获取分享的设备
bindAndShare:获取绑定及分享的设备
关系类型,子账号传该参数不起作用

样例输入

{
    "system": {
        "ver": "1.0",
        "appId": "lcdxxxxxxxxx",
        "sign": "xxxxxxxxxxxxxxx",
        "time": 1603370922,
        "nonce": "d1c25a03-0f75-4105-b2f8-ace0b7c25968"
    },
    "id": "04b3bdac-5a45-414d-a97a-922542a1d218",
    "params": {
        "pageSize": 10,
        "page": 1,
        "token": "xxxxxxxxxxxxxxxx",
        "source": "bindAndShare"
    }
}

返回data字段说明

字段名字段类型字段说明
countInteger本次查询到的设备数
deviceListupgradeInfoversionString最新版本号
attentionString升级描述信息
packageUrlString下载地址
deviceIdString设备序列号
productIdString产品编号
canBeUpgradeBoolean设备软件程序是否有新版本可以升级
accessTypeString设备接入类型,PaaS-表示Paas程序接入、Lechange-表示乐橙非PaaS设备、Easy4IP表示Easy4IP程序设备、P2P表示P2P程序设备
deviceVersionString设备版本号
playTokenString设备播放码,opensdk使用
brandString设备品牌信息:lechange-乐橙设备,general-通用设备
encryptModeString设备加密模式:0-设备默认加密 1-用户自定义加密
lastOffLineTimeString设备最后离线时间
bindTimeLong设备绑定时间,UNIX时间戳形式。仅自己绑定的设备会返回,分享、托管设备不返回
deviceNameString设备名称
deviceStatusString设备状态,online:在线,offline:离线,sleep:休眠,upgrading升级中
deviceModelString设备型号
catalogString设备大类【NVR/DVR/HCVR/IPC/SD/IHG/ARC】
deviceAbilityString设备能力集,逗号隔开
channelNumInteger设备最大支持接入的通道数
sourceString权限类型:bind、 share
isSubDeviceBoolean是否为子设备
parentDeviceIdString子设备所属的父设备序列号
parentProductIdString子设备所属的父设备产品id
channelListchannelPicUrlString设备通道封面图,新设备可能不存在封面图,可上传设备通道封面图或者刷新设备封面图
csStatusString云存储状态,notExist:未开通套餐,using:开通云存储且没有过期,expired:套餐过期
shareFunctionsString分享权限下的权限字符串,逗号隔开
cameraStatusString遮罩状态,on:打开,off:关闭
channelIdInteger通道号
channelNameString通道名称
channelAbilityString通道能力集,逗号隔开
channelStatusString通道状态,online:在线,offline:离线,sleep:休眠,upgrading升级中
lastOffLineTimeString通道最后离线时间
resolutionsnameString客户端界面展示的分辨率名称
imageSizeInteger分辨率枚举
streamTypeInteger码流类型,0:主码流,1:辅码流
subDeviceListsubDeviceProductIdString子设备产品id
subDeviceIdString子设备序列号
subDeviceNameString子设备名称
subDeviceModelString子设备型号
subDeviceStatusString子设备状态,online:在线,offline:离线
aplistapIdString配件id
apNameString配件名称
apTypeString配件类型

样例输出

{
    "result": {
        "msg": "操作成功。",
        "code": "0",
        "data": {
            "count": 1,
            "deviceList": [
                {
                    "catalog": "IPC",
                    "source": "bind",
                    "deviceId": "TESTQWERXXXX",
                    "deviceName": "TESTQWERXXXX",
                    "wifiTransferMode": "2.4Ghz",
                    "deviceStatus": "offline",
                    "accessType": "PaaS",
                    "channelList": [
                        {
                            "csStatus": "expired",
                            "shareFunctions": "",
                            "cameraStatus": "off",
                            "lastOffLineTime": "20220919T165230Z",
                            "channelName": "TESTQWERXXXX",
                            "channelStatus": "offline",
                            "resolutions": [],
                            "channelAbility": "WLAN,MT,HSEncrypt,CloudStorage,LocalStorage",
                            "resolutions": [
                                {
                                    "streamType": 0,
                                    "name": "1080P",
                                    "imageSize": 18
                                },
                                {
                                    "streamType": 1,
                                    "name": "480P",
                                    "imageSize": 5
                                }
                            ],
                            "channelId": 0,
                            "channelPicUrl": ""
                        }
                    ],
                    "encryptMode": "0",
                    "tlsPrivatePort": "37778",
                    "brand": "lechange",
                    "devicePassword": "xxxxxxxx==",
                    "playToken": "",
                    "deviceUsername": "xxxxxxxxxxxxxx==",
                    "salt": "XXXXXXXXXXXXXXXXX",
                    "httpPort": "80",
                    "rtspPort": "554",
                    "channelNum": 1,
                    "deviceVersion": "xxxxxxxxx",
                    "sdcardStatus": "normal",
                    "subDeviceList":[],
                    "aplist": [],
                    "deviceAbility": "WLAN,MT,HSEncrypt,CloudStorage,LocalStorage,PlaybackByFilename",
                    "deviceModel": "TP2",
                    "canBeUpgrade": false
                }
            ]
        }
    },
    "id": "suyf3eocxog"
}
批量查询设备详细信息
获取设备在线状态