查询电站历史测点数据
接口描述
功能描述
根据电站ID查询电站下的历史测点数据。
访问限制
- 每个ip的限流次数：每分钟10次。
- 获取电站历史数据，一次最多支持查询50个电站。
请求方式
HTTPS调用
POST https://we.goodwe.com/api/openapi/v1/service/getStationPointsDayMonthYearDataList
Header参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | String | 是 | 用户token |
请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| stationIdList | 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 | List<Object> | 电站状态 | key:5000,value:正常（当电站正常运行时默认值） |
| data.dataList.dataList | Object | 电站具体数据 | - |
| data.dataList.dataList.date | String | 时间 | 累计：null，年：2024 月：2024-03 日：2024-11-01 |
| data.dataList.dataList.metrics | Object | 测点数据 | - |
其他说明
附录中未返回的字段默认为0
调用示例
请求数据示例
json{ "stationIdList": ["1746767166860034048"], "dimension": "year", "startDate":"2020-01-01", "endDate":"2024-12-31" }
返回数据示例
样例1：返回电站历史数据成功
json{ "code": "00000", "description": "成功", "data": { "dataList": [ { "thingId": "1619145966919745536", "name": "统一指标电量和收益at勿动！！", "state":[{"key":5000,"value":"正常"}], "dataList": [ { "date": "2024-06-25", "metric": { "epPeak": 227.99, "gridEDeep": 90.9, "selfProfit": -139.92, "selfUseE": -50.12, "epDeep": 88.99, "selfProfitFlat": -114.59, "gridEFlat": 171.62, "selfUseEFlat": -40.94, "selfUseEDeep": -12.95, "costTotalFlat": 421.85, "ep": 467.64, "costTotalDeep": 226.04, "profitTotal": 266.99, "costTotal": 1103.88, "genEp": 311.55, "genEpPeak": 161.9, "selfUseEPeak": 3.71, "selfProfitPeak": 7.44, "costTotalPeak": 455.98, "epReactive": 472.48, "eFlat": 130.68, "ePeak": 193.31, "eReactive": 519.13, "eDeep": 77.95, "gridE": 452.13, "epFlat": 150.66, "selfProfitDeep": -32.82, "genEpFlat": 92.39, "reactiveTotal": 631.91, "gridProfit": 406.91, "gridEPeak": 189.6, "eTotal": 402.01, "genEpDeep": 57.24, "weightedEPrice": 0.664138 } }, { "date": "2024-06-24", "metric": {} }, { "date": "2024-06-23", "metric": {} }, { "date": "2024-06-22", "metric": {} } ] } ] } }
