查询设备列表
调用此接口,条件查询设备列表。
接口路径
/api/device/getDeviceList
请求方式
[GET]
请求参数
路径参数:
| 参数名称 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| page | number | 是 | 页码,从0开始,默认为0 |
| size | number | 是 | 每页记录数,最大为100,默认为10 |
| pk | String | 否 | 产品pk |
| keyword | String | 否 | 模糊搜索关键词,设备名称或设备ID |
| deviceType | String | 否 | 节点类型。普通设备:GENERAL;中继设备:SWITCH;网关设备:GATEWAY;终端子设备:TERMINAL |
| online | boolean | 否 | 设备在离线状态,true为在线 |
Headers:
| 参数名称 | 参数值 | 是否必须 |
|---|---|---|
| Authorization | {token} | 是 |
- 其中token获取方式参考使用AccessKey计算token。
返回参数
| 名称 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| totalElements | number | 是 | 查询记录总数 |
| totalPages | number | 是 | 查询记录总页数 |
| page | String | 是 | 页码 |
| size | String | 是 | 每页记录数 |
| content | array | 是 | 查询到的设备信息 |
| 以下为content内容 | - | - | - |
| name | String | 否 | 设备名称 |
| createdDate | number | 否 | 创建时间(ms) |
| updatedDate | number | 否 | 更新时间(ms) |
| enable | boolean | 否 | 是否可用 |
| pk | String | 否 | 所属产品pk |
| devId | String | 否 | 设备devId |
| online | boolean | 否 | 在线状态 |
| devSecret | String | 否 | 设备密钥 |
| loginTime | number | 否 | 最近一次登录时间(ms) |
| logoutTime | number | 否 | 最后一次登出时间(ms) |
| registerTime | number | 否 | 注册时间(ms) |
| firstLoginTime | number | 否 | 上电激活时间(ms) |
| deviceType | String | 否 | 设备类型 |
| ipInfo | object | 否 | IP信息 |
| moduleVersion | String | 否 | 模组固件版本 |
| mcuVersion | String | 否 | mcu固件版本 |
| configVersion | String | 否 | 远程配置版本 |
| batchName | String | 否 | 批次名称 |
| imei | String | 否 | 设备imei |
【示例】:
{
"totalElements": 1,
"page": 0,
"size": 10,
"content": [
{
"rootPk": "a987e**********3fef6cee",
"name": "测试围栏3",
"rootDevId": "loc*******eway",
"parentPk": "a987e*********3fef6cee",
"parentDevId": "loca******eway",
"createdDate": 1600932306754,
"updatedDate": 1600932317186,
"enable": true,
"pk": "ab235db**********90c829db85",
"devId": "B01_F*******CE_00003",
"online": false,
"devSecret": "4098b97**********8fa73fbf8b",
"loginTime": 1600932317185,
"logoutTime": null,
"registerTime": 1600932306754,
"firstLoginTime": 1600932317185,
"deviceType": "TERMINAL",
"ipInfo": {
"ip": "10*.*.*.9",
"country": null,
"province": null,
"city": "内网IP"
},
"moduleVersion": null,
"mcuVersion": null,
"configVersion": null,
"batchName": null,
"imei": null,
"tags": null
}
],
"totalPages": 1
}