listSubAccountDevice（分页查询子账号有权限的设备）
listSubAccountDevice：分页查询子账号有权限的设备
功能说明
分页查询当前子账号已授权的设备及其权限策略。
请求地址
https://openapi-[DataCenter].easy4ip.com/openapi/listSubAccountDevice
请求格式
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法取值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员 accessToken | ||
| pageNo | Integer | 否 | 1 | 分页页码，从 1 开始 | |
| pageSize | Integer | 否 | 10 | 1–50 | 每页条数，默认 10，最大 50 |
| openid | String | 是 | 子账号 openid |
请求示例
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time":1603350473,
"nonce":"a4d59add-0f04-4b7e-9355-d1fb4e9dc22b"
},
"id":"d82a7fa7-655f-4bb8-ab75-72bb3dfa3a94",
"params":{
"token": "At_0000cc8b90811e774a10816d75c27998",
"pageNo": 1,
"pageSize": 10,
"openid":"5dd2fe5bc11240a9b5d4fd4474c857c5"
}
}
返回字段说明
| 字段名 | 字段类型 | 说明 |
|---|---|---|
| pageNo | String | 当前页码（JSON 中为字符串） |
| pageSize | String | 每页条数（JSON 中为字符串） |
| total | Integer | 有权限的设备总数 |
| policy | Array | 设备权限列表 |
| policy[].deviceId | String | 设备序列号 |
| policy[].permission | String | 设备级权限码（逗号分隔），如 Real、Config |
| policy[].channelIdPermissions | Array | 通道级权限 |
| policy[].channelIdPermissions[].channelId | Integer | 通道号 |
| policy[].channelIdPermissions[].permission | String | 通道权限码（逗号分隔） |
响应示例
{
"id": "123456",
"result": {
"code": "0",
"msg": "Successful operation",
"data": {
"policy": [
{
"deviceId": "TESTQWERXXXX",
"permission": "Real,Config",
"channelIdPermissions": [
{
"channelId": 0,
"permission": "RecordReplay"
},
{
"channelId": 1,
"permission": "Talk"
}
]
},
{
"deviceId": "TESTQWERYYYY",
"permission": "Real,RecordReplay,Talk",
"channelIdPermissions": []
}
],
"pageNo": "1",
"pageSize": "10",
"total": 2
}
}
}
错误码
网关与鉴权（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。