查询系统历史测点数据
接口描述
功能描述
根据系统ID查询系统下的历史测点数据。
访问限制
- 每个ip的限流次数：每分钟10次。
- 获取系统历史数据，一次最多支持查询50个系统。
请求方式
HTTPS调用
POST https://we.goodwe.com/api/openapi/v1/service/getSystemPointsDayMonthYearDataList
Header参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | String | 是 | 用户token |
请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| systemIdList | List<String> | 是 | 系统id集合 |
| dimension | String | 是 | 查询方式（day日、month月、year年、total累计）（默认year维度查询当年、month维度当年所有月、day维度当月所有日、累计） |
| startDate | String | 否 | 开始日期（yyyy-MM-dd格式）（day维度一次性可查31天、month维度一次性可查12个月、year不限制） |
| endDate | String | 否 | 结束日期（yyyy-MM-dd格式） |
| identityCode | String | 否 | 业主身份：assetsManage-资方，care-运维商，powerMonitorInvested-用能业主（被投），powerMonitor-用能业主（自投），vpp-虚拟电厂（默认assetsManage-资方 ） |
返回参数
| 属性 | 类型 | 说明 | 示例值 |
|---|---|---|---|
| code | String | 请求成功或失败标识，“00000”请求成功，其余code请求失败 | - |
| description | String | 请求结果描述 | - |
| data | Object | 返回数据 | - |
| data.dataList | List<Object> | 系统列表 | - |
| data.dataList.thingId | Long | 系统id | 1746767166860034048 |
| data.dataList.name | String | 系统名称 | 测试电站-lhh |
| data.dataList.state | String | 系统状态 | normal-正常,abnormal-异常 |
| data.dataList.stateName | String | 系统状态 | normal-正常,abnormal-异常 |
| data.dataList.dataList | Object | 系统具体数据 | - |
| data.dataList.dataList.date | String | 时间 | 累计：null，年：2024 月：2024-03 日：2024-11-01 |
| data.dataList.dataList.metrics | Object | 测点数据 | - |
其他说明
附录中未返回的字段默认为0
调用示例
请求数据示例
json{ "systemIdList": ["1746767166860034048"], "dimension": "month", "startDate":"2023-01-01", "endDate":"2023-12-30" }
返回数据示例
样例1：返回电站历史数据成功
json{ "code": "00000", "description": "成功", "data": { "dataList": [ { "thingId": "1619145966919745536", "name": "统一指标电量和收益at勿动系统！！", "state": "abnormal", "stateName": "异常", "dataList": [ { "date": "2024-06-25", "metric": { "selfProfit": -37.878463, "selfUseE": -69.158610, "eCritical": 1021.07383067, "gridEFlat": 229.34021783, "topGridProfitValley": 663.57694379, "equivalentTree": 1.967348, "topGenerateProfitCritical": 888.33423268, "topGridProfitPeak": 438.68309105, "profitTotalPV": 1977.736346, "selfUseEFlat": 10.063987, "eReactiveTotal": 3113.05432000, "savedProfitFlat": -5.635832, "topGenerateProfitValley": 629.56713013, "topGenerateProfitFlat": 134.06635443, "eValley": 1144.66750933, "savedProfitValley": 34.009814, "selfProfitPeak": -18.833148, "ePeak": 626.64170567, "topGridProfitDeep": 0, "netProfitPV": 1977.736346, "eReactive": 3136.48733000, "eDeep": 0, "gridE": 3100.94586000, "selfProfitValley": -34.009814, "selfProfitDeep": 0.000000, "gridProfit": 2015.61480900, "savedProfit": 37.878463, "weightedEPrice": 0.652333, "epReactiveTotal": 3108.53312000, "gridEDeep": 0, "gridECritical": 1010.35122583, "topGenerateProfitDeep": 0, "epTotal": 3029.043370, "selfProfitFlat": 5.635832, "selfUseEDeep": 0.000000, "selfUseRate": -0.022811, "ep": 3098.20198000, "topGenerateProfitPeak": 419.84994280, "topGenerateProfit": 2071.81766004, "topGridProfitFlat": 128.43052199, "selfUseEValley": -61.836025, "genEp": 3064.05683000, "savedProfitPeak": 18.833148, "selfProfitCritical": 9.328666, "selfUseEPeak": -28.109177, "topGridProfit": 2109.69612331, "epReactive": 3138.22432000, "eFlat": 239.40420433, "topGridProfitCritical": 879.00556648, "savedProfitDeep": 0.000000, "saveCoal": 1.212715, "reactiveTotal": 6221.587440, "gridEValley": 1206.50353417, "gridEPeak": 654.75088217, "savedProfitCritical": -9.328667, "eTotal": 3031.78725000, "greenERate": -0.022832, "co2Reduction": 1.440099, "selfUseECritical": 10.722605 } }, { "date": "2024-06-24", "metric": {} }, { "date": "2024-06-23", "metric": {} }, { "date": "2024-06-22", "metric": {} } ] } ] } }
