authorizedDeviceList(分页获取已托管的设备详情)
authorizedDeviceList:分页获取已托管的设备详情
要点:https://openapi.lechange.cn/openapi/authorizedDeviceList · 见 错误码
开发者调用此接口分页获取已托管的设备详情
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员accessToken | ||
| page | Integer | 是 | 整数 | 第几页 | |
| pageSize | Integer | 是 | 1-20 | 每页数量 |
请求示例
{
"system": {
"ver": "1.0",
"appId": "lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time": 1620869414,
"nonce": "8b0c169b-25a8-464c-a12d-0cfe16fc4657"
},
"id": "f8d6722a-0e34-44c9-a2bd-219b765bb8ef",
"params": {
"pageSize": 1,
"page": 1,
"token": "<yourAccessToken>"
}
}
响应字段
| 字段名 | 字段类型 | 字段说明 | ||
|---|---|---|---|---|
| deviceList | deviceId | String | 设备序列号 | |
| status | String | 设备状态,online:在线,offline:离线,sleep:休眠,upgrading升级中 | ||
| deviceModel | String | 设备型号 | ||
| catalog | String | 设备大类【NVR/DVR/HCVR/IPC/SD/IHG/ARC】 | ||
| version | String | 设备软件版本号 | ||
| name | String | 设备名称 | ||
| ability | String | legacy 能力逗号串;**v2 能力发现**用 [device.capability.list](/api/device.capability.list/) 或 [能力使用](/capabilities/usage/)。IoT 设备可能追加 `TCM` 等后缀 | ||
| productId | String | 可选。IoT 等设备型号 ID | ||
| sdCardStatus | String | 可选。本地存储卡状态(实现回填) | ||
| accessType | String | 设备接入类型,PaaS-表示Paas程序接入、Lechange-表示乐橙非PaaS设备、Easy4IP表示Easy4IP程序设备、P2P表示P2P程序设备 | ||
| encryptMode | String | 加密模式,0:默认加密模式,1:用户自定义加密模式 | ||
| owner | String | 设备拥有者手机号 | ||
| channelNum | String | 设备可接入通道数量 | ||
| channels | channelId | String | 通道号 | |
| channelName | String | 通道名称 | ||
| ability | String | 通道能力集,如AlarmMD,AudioTalk,逗号隔开 | ||
| status | String | 远程通道状态,online:在线,offline:离线,close:未配置,sleep:休眠,upgrading升级中 | ||
| picUrl | String | 缩略图URL | ||
| remindStatus | String | 提醒状态,off:不提醒,on:提醒 | ||
| shareFunctions | String | 托管的权限功能列表(逗号隔开) | ||
响应示例
{
"result": {
"msg": "操作成功。",
"code": "0",
"data": {
"deviceList": [
{
"accessType": "PaaS",
"owner": "183****5647",
"channels": [
{
"picUrl": "",
"shareFunctions": "RecordReplay,Format,Config,Siren,Alarm,Ptz,WhiteLight,Real,Talk,Upgrade,Capture",
"remindStatus": "1",
"channelName": "TP7i-3479",
"ability": "PTZ,MDW,MDS,ChnLocalStorage",
"channelId": "0",
"status": "offline"
}
],
"channelNum":"16",
"catalog": "ARC",
"encryptMode": 0,
"name": "TP7i-3479",
"deviceModel": "TP7i",
"ability": "WLAN,Auth,LocalStorageSceneMode,DDT,CK,RD,RDAlarmSound",
"deviceId": "TESTQWERXXXX",
"version": "2.145.1000.0.R.20181112",
"status": "offline"
}
]
}
},
"id": "f8d6722a-0e34-44c9-a2bd-219b765bb8ef"
}
错误码
本接口可能返回下列码;完整分组见 错误码。
网关与鉴权(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。
设备访问与通道(DV10xx)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
DV1007 | 设备离线或超时 | 等设备上线;低电休眠先 唤醒 |
DV1009 | 设备正忙 | 稍后重试 |
DV1012 | 分享/授权设备权限不足 | 核对子账号 Permission / Resource |
DV1019 | 能力集不支持 | 确认型号与 设备能力 |
DV1020 | 通道离线 | 检查通道与设备状态 |
DV1026 | 不支持此功能 | 换接口或升级固件 |
DV1028 | 未绑定或通道不存在 | 核对 deviceId / channelId |
DV1030 | 设备休眠 | 唤醒后再调 |
DV1057 | 通道不存在 | 核对通道号 |
DV1061 | 设备响应超时 | 检查设备网络 |
DV1062 | 需先唤醒设备 | 调用唤醒接口 |
DV1069 | 不满足操作条件 | 见 msg |
说明
仅支持管理员 accessToken;子账号不可调用本接口。
相关
- 03.设备管理
- deviceListByAuthStatus · setDeviceAuthStatus
- 接收终端用户托管的设备
- 分页详情(不含托管授权;托管清单用本接口等组合)