listDeviceDetailsByPage（分页查询设备详情）

listDeviceDetailsByPage：分页查询设备详情

已弃用： 新接入请使用分页设备详情（device.detail.page）。本页仅供存量 HTTP 对接查阅。

功能说明

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

请求地址

https://openapi-[DataCenter].easy4ip.com/openapi/listDeviceDetailsByPage

请求格式

POST JSON 请求体见请求约定；签名见签名。

请求参数

参数名	参数类型	是否必填	默认值	合法取值	参数说明
pageSize	int	是			每页条数，范围 1–50
page	long	是			页码，从 1 开始
token	String	是			管理员或子账号 accessToken
source	String		bindAndShare	bind：仅绑定设备 share：仅分享设备 bindAndShare：绑定与分享设备	关系类型；传入子账号 token 时本参数无效

请求示例

{
 "system": {
 "ver": "1.0",
 "appId": "lcdxxxxxxxxx",
 "sign": "xxxxxxxxxxxxxx",
 "time": 1603370757,
 "nonce": "1a411d5a-e88b-45ee-b590-53da98375edd"
 },
 "id": "beb24691-d173-473a-8d3d-92db3aee0027",
 "params": {
 "token": "xxxxxxxxxxxxxxxxxxxxxxxxx",
 "page": 1,
 "pageSize": 10,
 "source": "bindAndShare"
 }
}

返回 data 字段

字段名	字段类型	字段说明
count	Integer	本次查询命中的设备数量
deviceList.upgradeInfo.version	String	最新版本号
deviceList.upgradeInfo.attention	String	升级说明
deviceList.upgradeInfo.packageUrl	String	下载地址
deviceList.deviceId	String	设备序列号
deviceList.productId	String	产品唯一 ID
deviceList.canBeUpgrade	Boolean	设备程序是否可升级
deviceList.accessType	String	设备接入类型：空表示开放平台程序接入；Lechange 表示乐橙/Imou 常规接入设备；Easy4IP 表示 Easy4IP 程序设备；P2P 表示 P2P 程序设备
deviceList.deviceVersion	String	设备版本号
deviceList.playToken	String	设备播放码，供 OpenSDK 使用
deviceList.brand	String	设备品牌：lechange 为 Imou 设备，general 为通用设备
deviceList.encryptMode	String	设备加密模式：0 设备默认加密，1 用户自定义加密
deviceList.lastOffLineTime	String	设备上次离线时间
deviceList.deviceName	String	设备名称
deviceList.deviceStatus	String	设备状态：online 在线 / offline 离线 / sleep 休眠 / upgrading 升级中
deviceList.deviceModel	String	设备型号
deviceList.catalog	String	设备品类：NVR/DVR/HCVR/IPC/SD/IHG/ARC
deviceList.deviceAbility	String	设备能力集，逗号分隔
deviceList.channelNum	Integer	设备支持接入的最大通道数
deviceList.source	String	权限类型：bind 绑定 / share 分享
deviceList.isSubDevice	Boolean	是否为子设备
deviceList.parentDeviceId	String	所属父设备序列号
deviceList.parentProductId	String	所属父设备 productId
deviceList.channelList.channelPicUrl	String	通道封面图 URL
deviceList.channelList.csStatus	String	云存储状态：notExist 未开通套餐，using 已开通且未过期，expired 套餐已过期
deviceList.channelList.shareFunctions	String	分享权限下的权限字符串，逗号分隔
deviceList.channelList.cameraStatus	String	镜头遮蔽：on 开启，off 关闭
deviceList.channelList.channelId	String	通道号
deviceList.channelList.channelName	String	通道名称
deviceList.channelList.channelAbility	String	通道能力集，逗号分隔
deviceList.channelList.channelStatus	String	通道状态：online 在线 / offline 离线 / sleep 休眠 / upgrading 升级中
deviceList.channelList.lastOffLineTime	String	通道上次离线时间
deviceList.channelList.resolutions.name	String	客户端展示的分辨率名称
deviceList.channelList.resolutions.imageSize	Integer	分辨率枚举值
deviceList.channelList.resolutions.streamType	Integer	码流类型：0 主码流，1 辅码流
deviceList.subDeviceList.subDeviceProductId	String	子设备产品 ID
deviceList.subDeviceList.subDeviceId	String	子设备序列号
deviceList.subDeviceList.subDeviceName	String	子设备名称
deviceList.subDeviceList.subDeviceModel	String	子设备型号
deviceList.subDeviceList.subDeviceStatus	String	子设备状态：online 在线 / offline 离线
deviceList.aplist.apId	String	配件 ID
deviceList.aplist.apName	String	配件名称
deviceList.aplist.apType	String	配件类型

响应示例

{
 "result": {
 "msg": "操作成功.",
 "code": "0",
 "data": {
 "count": 1,
 "deviceList": [
 {
 "catalog": "IPC",
 "source": "bind",
 "deviceId": "TESTQWERXXXX",
 "deviceName": "TP7-XXXX",
 "wifiTransferMode": "2.4Ghz",
 "deviceStatus": "online",
 "accessType": "",
 "channelList": [
 {
 "csStatus": "using",
 "shareFunctions": "",
 "cameraStatus": "off",
 "lastOffLineTime": "20230921T212756Z",
 "channelName": "TP7-XXXX",
 "channelStatus": "online",
 "resolutions": [
 {
 "streamType": 0,
 "name": "1080P",
 "imageSize": 18
 },
 {
 "streamType": 1,
 "name": "480P",
 "imageSize": 5
 }
 ],
 "channelAbility": "CloseCamera,other,NVM,PT,WideDynamic",
 "channelId": 0,
 "channelPicUrl": ""
 }
					],
 "encryptMode": "0",
 "tlsPrivatePort": "37778",
 "brand": "lechange",
 "devicePassword": "xxxxxxxxxxxx",
 "playToken": "",
 "deviceUsername": "xxxxxxxx==",
 "salt": "xxxxxxxxxxxx",
 "upgradeInfo": {
 "packageUrl": "xxxxxxxxxxxxx",
 "attention": "Improve device performance and reinforce safety",
 "appForced": false,
 "isAppForced": false,
 "version": "V2.680.0000000.28.R.210911"
 },
 "httpPort": "80",
 "rtspPort": "554",
 "channelNum": 1,
 "deviceVersion": "xxxxxxxxxxx",
 "sdcardStatus": "normal",
 "subDeviceList":[],
 "aplist": [],
 "deviceAbility": "WLAN,Auth,HSEncrypt,BreathingLight,CloudStorage,LocalStorage",
 "lastOffLineTime": "20220926T164059Z",
 "deviceModel": "TP7",
 "canBeUpgrade": true
 }
 ]
 }
 },
 "id": "20tboni0x9z"
}

错误码

本接口可能返回下列码；完整分组见错误码与能力错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名校验异常	按 HTTP 开发规范核对 `sign`
`TK1002`	token 无效或过期	重新获取 accessToken
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1009`	权限不足	核对 token 与设备绑定/分享权限
`OP1013`	接口总次数超限	降低调用频率
`OP1014`	接口日限额超限	见接口调用限额
`DV1007`	设备离线	等设备上线

更多见错误码 · OP/SN/TK。

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`–`SUB1002`	子账号无接口权限	在 addPolicy 中补策略
`SUB1005`	子账号 token 过期	重新 subAccountToken
`SUB1006`	子账号与设备无授权	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定应用	先创建并绑定子账号

更多见错误码 · SUB。

设备访问与通道（DV10xx）

错误码	错误码说明	下一步
`DV1007`	设备离线或超时	等设备上线
`DV1009`	设备正忙	稍后重试
`DV1012`	分享/授权设备权限不足	核对子账号 `Permission` / `Resource`
`DV1019`	能力集不支持	确认型号与能力列表
`DV1020`	通道离线	检查通道状态
`DV1026`	不支持此功能	换接口或升级固件
`DV1028`	未绑定或通道不存在	核对 `deviceId` / `channelId`

更多见错误码 · DV。