subAccountDeviceList(分页获取子账号下授权设备的详细信息)
subAccountDeviceList:分页获取子账号下授权设备的详细信息
要点:https://openapi.lechange.cn/openapi/subAccountDeviceList · 见 错误码
分页获取子账号下授权设备的详细信息,仅限子账号token调用
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 子账号Token | ||
| page | Integer | 否 | 1 | ≥1 的整数,默认 1 | 分页参数,第几页 |
| pageSize | Integer | 否 | 10 | 1-20 | 分页参数,每页数量 |
请求示例
{
"system": {
"ver": "1.0",
"appId": "lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time": 1623987465,
"nonce": "39ed36aa-1fac-4e80-83c9-3b457db70ecd"
},
"id": "733b6b5c-05ce-4734-b407-e30dac44e637",
"params": {
"pageSize": 1,
"page": 2,
"token": "St_0000dc28d3ac63bf4cb5ad0e7e2ba731"
}
}
响应字段
| 字段名 | 字段类型 | 字段说明 | |||
|---|---|---|---|---|---|
| count | Integer | 设备总量 | |||
| deviceList | deviceId | String | 设备序列号 | ||
| status | String | 设备状态,online:在线,offline:离线,sleep:休眠,upgrading升级中 | |||
| deviceModel | String | 设备型号 | |||
| catalog | String | 设备大类【NVR/DVR/HCVR/IPC/SD/IHG/ARC】 | |||
| version | String | 设备软件版本号 | |||
| name | String | 设备名称 | |||
| permission | String | 设备权限,若只授权通道级别权限,则此字段不返回内容 | |||
| ability | String | legacy 能力串(逗号分隔)。新接入看 V2 `capabilityIds`([device.capability.list](/api/device.capability.list/));对照 [遗留能力集](/api/legacy/ability-switch/) | |||
| accessType | String | 设备接入类型,PaaS-表示Paas程序接入、Lechange-表示乐橙非PaaS设备、Easy4IP表示Easy4IP程序设备、P2P表示P2P程序设备 | |||
| encryptMode | String | 加密模式,0:默认加密模式,1:用户自定义加密模式 | |||
| channelNum | String | 设备可接入通道数量 | |||
| channels | channelId | String | 通道号 | ||
| channelName | String | 通道名称 | |||
| ability | String | 通道能力集,如AlarmMD,AudioTalk,逗号隔开 | |||
| status | String | 远程通道状态,online:在线,offline:离线,close:未配置,sleep:休眠,upgrading升级中 | |||
| permission | String | 通道权限,若只授权设备级别权限,则按照设备级别权限填充 | |||
| picUrl | String | 缩略图URL | |||
| resolutions | name | String | 客户端界面展示的分辨率名称 | ||
| imageSize | Integer | 分辨率枚举 | |||
| streamType | Integer | 码流类型,0:主码流,1:辅码流 | |||
| aplist | apId | String | 配件id | ||
| apName | String | 配件名称 | |||
| apType | String | 配件类型 | |||
| apModel | String | 配件的型号 | |||
| ioType | String | 配件的io类型,in:输入,out:输出 | |||
| apVersion | String | 配件的版本号 | |||
| apStatus | String | 配件的在线状态,online:在线,offline:离线 | |||
| apEnable | String | 配件的使能,on:使能开启,off:使能关闭 | |||
| apCapacity | String | 配件能力项,逗号隔开,如AudioTalk,PT | |||
响应示例
{
"result": {
"msg": "操作成功。",
"code": "0",
"data": {
"count": 10,
"deviceList": [{
"accessType": "PaaS",
"catalog": "NVR",
"encryptMode": 0,
"name": "NVR-4993",
"channelNum": "64",
"deviceModel": "DH-NVR5232-I",
"permission": "",
"ability": "Auth,DHP2P,CloudStorage,LocalStorage, PlaybackByFilename,MT,CK,RD",
"deviceId": "DEVXXXXXXXXXX",
"version": "2.145.1000.0.R.20181112",
"status": "offline",
"channels": [{
"picUrl": "",
"channelName": "NVR-4993-4",
"permission": "Alarm,Talk,Ptz,Config,Upgrade",
"ability": "PTZ,MDW,MDS,ChnLocalStorage",
"channelId": "3",
"status": "offline",
"resolutions":[{
"name": "1080P",
"imageSize": 18,
"streamType": 0
}]
}],
"aplist":[{
"apId": "APXXXXXXXXXXX",
"apName": "cname",
"apType": "ability",
"apModel": "wbs",
"ioType": "auto",
"apVersion": "V1.2.3",
"apStatus": "online",
"apEnable": "on",
"apCapacity": "AudioTalk,PT"
}]
}]
}
},
"id": "733b6b5c-05ce-4734-b407-e30dac44e637"
}
错误码
本接口可能返回下列码;完整分组见 错误码。
网关与鉴权(SN / TK / OP)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SN1001 | 签名异常 | 按 签名 核对 sign |
TK1002 | token 无效或过期 | 重新获取 token |
OP1002 | 缺少必填参数 | 补必填字段 |
OP1003 | 参数不合法 | 按本页参数表核对 |
OP1039 | 分钟级限流 | 等到下一分钟再试 |
OP1040 | 调用超限 | 降低频率 |
DV1007 | 设备离线或超时 | 等设备上线 |
子账号(SUB)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SUB1001 | 子账号无指定权限 | 在 子账号策略 中补权限 |
SUB1002 | 子账号无任何设备权限 | 授权设备或调整策略 |
SUB1005 | 子账号 token 过期 | 重新 获取子账号 token |
SUB1006 | 子账号与设备无授权关系 | 核对 Resource 与设备序列号 |
SUB1008 | 子账号未绑定当前应用 | 先创建并绑定子账号 |
SUB1007 | 创建子账号失败 | 核对参数后重试 |
SUB1009 | 子账号创建失败,账号格式错误 | account 须为手机号或邮箱 |
SUB1010 | 子账号创建失败,账号已存在 | 勿重复绑定同一子账号到应用 |
更多见 错误码 · SUB。
说明
仅限子账号 accessToken 调用;须使用本子账号签发的 token。管理员 token 不可调用。
新接入优先 分页详情(子账号 token + openid)。本接口为 legacy 分页,字段形态见上文 ability 等;与 V2 差异见 设备管理说明。