deviceOpenList（分页获取开放平台设备通道基础信息）
deviceOpenList：分页获取开放平台设备通道基础信息
遗留 HTTP 保留： 供已有对接继续调用。新接入请见 设备 API 总览。
遗留 HTTP： 供已有对接继续调用。新接入请从 设备 API 总览与 V2 查询方法选型。
相关当前接口： 新接入也可参考 分页设备详情（
device.detail.page）。 本 HTTP 方法仍保留在当前路径，权威材料未给出一对一替代。
功能说明
分页获取开放平台已添加设备的通道基础信息。
说明：查询 easy4ip 应用绑定的设备请使用 deviceBaseList 接口。
请求地址
https://openapi-[DataCenter].easy4ip.com/openapi/deviceOpenList
请求格式
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法取值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员 accessToken | ||
| bindId | Long | 是 | 取值 [-1,N]，-1 表示从首条开始查询 | 上次查询最后一条设备的 Id | |
| limit | Integer | 是 | 最大 128 | 本次返回条数 | |
| type | String | 是 | bind：绑定设备；share：分享设备；bindAndShare：绑定与分享设备 | 绑定类型 | |
| needApInfo | Boolean | 是 | true：需要；false：不需要 | 是否返回配件列表 |
请求示例
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time":1603370922,
"nonce":"d1c25a03-0f75-4105-b2f8-ace0b7c25968"
},
"id":"04b3bdac-5a45-414d-a97a-922542a1d218",
"params":{
"limit":"128",
"type":"bind",
"bindId":"-1",
"token":"At_00000ad9e6e87f0142eb92e207aec46a",
"needApInfo":"true"
}
}
返回 data 字段
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| count | Integer | 本次查询的设备数量 |
| deviceList.bindId | Long | 绑定/分享表自增 ID |
| deviceList.deviceId | String | 设备序列号 |
| deviceList.channels.channelId | String | 通道号 |
| deviceList.channels.channelName | String | 通道名称 |
| deviceList.aplist.apId | String | 配件 ID |
| deviceList.aplist.apName | String | 配件名称 |
| deviceList.aplist.apType | String | 配件类型 |
响应示例
{
"result":{
"msg":"操作成功.",
"code":"0",
"data":{
"count":3,
"deviceList":[
{
"channels":[
{
"channelName":"TP1S-1842",
"channelId":"0"
}
],
"deviceId":"TESTQWERXXXX",
"bindId":16425764,
"aplist":[
]
},
{
"channels":[
{
"channelName":"TP1S-1375",
"channelId":"0"
}
],
"deviceId":"TESTQWERXXXX",
"bindId":15540451,
"aplist":[
]
},
{
"channels":[
{
"channelName":"IPC-6683",
"channelId":"0"
}
],
"deviceId":"TESTQWERXXXX",
"bindId":15394252,
"aplist":[
]
}
]
}
},
"id":"04b3bdac-5a45-414d-a97a-922542a1d218"
}
错误码
网关与鉴权（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）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
DV1001 | 已被其他账号绑定 | 解绑或换设备 |
DV1002 | 设备不存在 | 核对序列号 |
DV1003 | 已被当前账号绑定 | 无需重复绑定 |
DV1005 | 验证码错误 | 核对设备机身码 |
DV1008 | 绑定数量超限 | 解绑冗余设备 |
DV1011 | 设备未绑定 | 先执行绑定 |
DV1029 | 设备已被绑定 | 勿重复绑定 |
更多见 错误码 · DV。