查询设备实时测点数据
接口描述
功能描述
根据设备NodeId查询设备的实时测点数据。
访问限制
- 每个ip的限流次数：每分钟10次。
- 获取设备实时数据，一次最多支持查询100个设备。
请求方式
HTTPS调用
POST https://we.goodwe.com/api/openapi/v1/service/getDeviceRealTimeData
Header参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | String | 是 | 用户token |
请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| deviceNodeList | List<Long> | 是 | 设备节点id集合 |
返回参数
| 属性 | 类型 | 说明 | 示例值 |
|---|---|---|---|
| code | String | 请求成功或失败标识，“00000”请求成功，其余code请求失败 | - |
| description | String | 请求结果描述 | - |
| data | Object | 返回数据 | - |
| data.dataList | List<Object> | 设备列表 | - |
| data.dataList[].nodeId | Long | 设备节点 | 1762388313995608066 |
| data.dataList[].name | String | 设备名称 | 智能电表-1组 |
| data.dataList[].sn | String | 设备sn | guizejuhenbq19 |
| data.dataList[].stationId | String | 所属场站id | 1742449261636855336 |
| data.dataList[].systemId | String | 所属系统id | 1789836820771635200 |
| data.dataList[].state | String | 设备状态 | 1000-运行,1001-待机,1002-故障,1003-停机,1004-休眠,1005-离线,1011-异常 |
| data.dataList[].stateName | String | 设备状态 | 1000-运行,1001-待机,1002-故障,1003-停机,1004-休眠,1005-离线,1011-异常 |
| data.dataList[].tp | String | 数据采集时间 | 1719367360144 |
| data.dataList[].tpTime | String | 数据采集时间 | 2024-06-26 10:02:40 |
| data.dataList[].metric | Object | 测点数据 | - |
其他说明
附录中未返回的字段默认为0
调用示例
请求数据示例
json{ "deviceNodeList": [1851541115279376384] }
返回数据示例
样例1：返回设备实时数据成功
json{ "code": "00000", "description": "成功", "data": { "dataList": [ { "name": "cyd测试逆变器1", "nodeId": "1496388678040289280", "sn": "cydcsnbq1", "state": "1000", "stateName": "运行", "tp": "1719367360144", "tpTime": "2024-06-26 10:02:40", "metric": { "i31": 19.7, "i30": 1.67, "errorCode": 1, "i32": 13.15, "warnCode": 1.76, "ua": 7.23, "ub": 5.95, "ia": 4.19, "ib": 18.02, "pmdMonth": 17828.144036987087, "ic": 8.26, "state": 1, "en": 6.193596024351315, "ep": 0, "invalid": 19.75, "tIn": 26.92, "fa": 18.54, "fb": 17.97, "fc": 7.39, "workMode": 18.97, "i11": 17.46, "i10": 6.09, "i13": 1.94, "i12": 18.6, "epReactive": 2.906947562886461, "i15": 9.74, "i14": 2.13, "i17": 3.63, "i16": 14.17, "i19": 7.91, "duration": "1719367363664", "i18": 1.46, "u11": 3.94, "u10": 15.83, "u13": 8.58, "u12": 9.12, "u15": 18.13, "u14": 7.36, "eDay": 237.97749, "u17": 15.72, "u16": 7.25, "eReactive": 3.674604777037194, "u1": 5.7, "u19": 17.46, "u2": 1.84, "u18": 5.11, "u3": 6.83, "u4": 13.33, "u5": 14.67, "u6": 16.54, "u7": 4.67, "u8": 9.65, "u9": 17.33, "e": 13171.37545, "f": 5.15, "i20": 12.03, "i22": 15.97, "i1": 19.6, "i21": 15.18, "i": 91.15713542548188, "i2": 16.49, "i24": 14.78, "i3": 1.47, "i23": 6.17, "i4": 9.7, "i26": 13.39, "i5": 13.78, "i25": 9.45, "i6": 11.51, "i28": 6.08, "i7": 7.28, "i27": 14.9, "i8": 16.58, "p": 10.23, "i9": 9.6, "q": 19.8, "i29": 11.46, "pa": 12.1, "u20": 7.8, "pb": 14.21, "s": 49376.697380075864, "pc": 11.9, "t": 26.92, "u22": 6.41, "u21": 6.24, "u": 520.5888872101102, "u24": 19.67, "pf": 1.55, "u23": 1.67, "u26": 1.76, "u25": 16.36, "u28": 11.08, "u27": 13.87, "gate": "1" } } ] } }
