电站图表数据相关
获取电站相关数据及图表
接口描述
通过指定日期、监控电站 ID 和图表数据类型，获取电站的数据和图表。
请求方法
/sol_monitor/iot/plant
请求方式
POST
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 | 备注 |
|---|---|---|---|---|---|
| X-Access-Token | header | string | 是 | token | |
| body | body | json | 是 | ||
| » plantId | body | String | 是 | 监控电站 id | |
| » keyList | body | List | 是 | 获取数据 key 值 | |
| » date | body | String | 否 | 查询时间 | |
| » isNow | body | String | 否 | 是否获取七/三日数据 | 0-否 1-是 |
| » endDate | body | String | 否 | 查询结束时间 | |
| » dateEnum | body | String | 否 | 查询数据格式 | |
| » deviceIdList | body | List | 否 | 聚合设备列表 | |
| » version | body | int | 否 | 版本：1 |
枚举值 1
| 属性 | 值 | 说明 | 备注 |
|---|---|---|---|
| keyList | E_AMMETER_DAY | 电站的电表当日发电量 | |
| keyList | E_AMMETER_MONTH | 电站的电表当月发电量 | |
| keyList | E_AMMETER_YEAR | 电站的电表当年发电量 | |
| keyList | E_AMMETER_TOTAL | 电站的电表历史发电量 | |
| keyList | E_DAY | 电站的逆变器当日发电量 | |
| keyList | E_MONTH | 电站的逆变器当月发电量 | |
| keyList | E_YEAR | 电站的逆变器当年发电量 | |
| keyList | E_TOTAL | 电站的逆变器历史发电量 | |
| keyList | SEVEN_EQUIVALENT_GENERATION_HOURS_MONTH_ARR | 电站的等效发电小时数 7 天图表 | 参数【date、isNow】必填 |
| keyList | EQUIVALENT_GENERATION_HOURS_MONTH_ARR | 电站的等效发电小时数月图表 | 参数【date】必填 |
| keyList | EQUIVALENT_GENERATION_HOURS_YEAR_ARR | 电站的等效发电小时数年图表 | 参数【date】必填 |
| keyList | EQUIVALENT_GENERATION_HOURS_TILL_NOW_ARR | 电站的等效发电小时数至今图表 | 参数【date】必填 |
| keyList | E_POWER_ARR | 电站的今日发电功率图表 | 参数【date】必填 |
| keyList | THREE_E_POWER_ARR | 电站的 3 日发电功率图表 | 参数【date、isNow】必填 |
| keyList | E_AMMETER_MONTH_ARR | 电站的电表发电量月图表 | 参数【date】必填 |
| keyList | E_INTERNET_MONTH_ARR | 电站的电表上网电量月图表 | 参数【date】必填 |
| keyList | SEVEN_E_AMMETER_MONTH_ARR | 电站的电表发电量 7 天图表 | 参数【date、isNow】必填 |
| keyList | SEVEN_E_INTERNET_MONTH_ARR | 电站的电表上网电量 7 天图表 | 参数【date、isNow】必填 |
| keyList | E_AMMETER_YEAR_ARR | 电站的电表发电量年图表 | 参数【date】必填 |
| keyList | E_INTERNET_YEAR_ARR | 电站的电表上网电量年图表 | 参数【date】必填 |
| keyList | E_AMMETER_TILL_NOW_ARR | 电站的电表发电量至今图表 | 参数【date】必填 |
| keyList | E_INTERNET_TILL_NOW_ARR | 电站的电表上网电量至今图表 | 参数【date】必填 |
| keyList | AMMETER_EQUIVALENT_GENERATION_HOURS_ARR | 电站的电表等效发电小时数至今图表 | 参数【date】必填 |
| keyList | E_AMMETER_DAY_ARR | 电站的电表发电量日图表 | 参数【date】必填 |
| keyList | E_INTERNET_DAY_ARR | 电站的电表上网电量日图表 | 参数【date】必填 |
| keyList | EQUIVALENT_SUNSHINE_HOURS | 电站的等效日照小时数图表 | 参数【date】必填 |
| keyList | IRRADIANCE | 电站的辐照量图表 | 参数【date、endDate、dateEnum、version】必填 |
| keyList | IRRADIANCE_ARR | 电站的辐照度图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | PLANT_INVERTER_PR_ARR | 电站的逆变器 PR 图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | PLANT_TOTAL_ENERGY | 电站的逆变器聚合的发电量图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | ACTUAL_GENERATION | 电站的逆变器实际发电量图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | LOST_GENERATION | 电站的逆变器损失发电量图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | THEORETICAL_ACTUAL_GENERATION | 电站的逆变器理论发电量图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | PLANT_INVERTER_ENERGY | 电站的逆变器发电量图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | PLANT_UNIT_AVG_ENERGY | 电站的逆变器每千瓦日均发电量图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | PLANT_UNIT_EEERGY | 电站的逆变器聚合的单位发电量图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | AC_POWER_ARR | 电站的逆变器的交流功率图表 | 参数【date、deviceIdList、dateEnum、version】必填 |
| keyList | HOTSPOT_CHART_ARR | 电站的热点图 | 参数【date】必填 |
| 属性 | 值 | 说明 | 备注 |
|---|---|---|---|
| dateEnum | DAY | 日每小时数据图表 | 参数【endDate】必填 |
| dateEnum | MORE_DAY | 七日每日数据图表 | 参数【endDate】必填 |
| dateEnum | MONTH | 月每日数据图表 | |
| dateEnum | YEAR | 年每月数据图表 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果的提示消息 | ||
| » code | integer | true | 请求状态码 | ||
| » result | object | true | 电站数据 | ||
| »» **** | **** | true | 传入的 key 对应的值 | ||
| » timestamp | integer | true | 响应数据的时间戳 |
result示例
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» E_AMMETER_DAY | string | true | 传入的数据 key 值 | ||
| »» E_AMMETER_MONTH | string | true | 传入的数据 key 值 | ||
| »» E_AMMETER_YEAR | string | true | 传入的数据 key 值 | ||
| »» E_AMMETER_TOTAL | string | true | 传入的数据 key 值 | ||
| »» E_DAY | string | true | 传入的数据 key 值 | ||
| »» E_MONTH | string | true | 传入的数据 key 值 | ||
| »» E_YEAR | string | true | 传入的数据 key 值 | ||
| »» E_TOTAL | string | true | 传入的数据 key 值 |
上述key返回结构如下
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"E_AMMETER_DAY": "2110.000000000233"
},
"timestamp": 1737705355695
}
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» EQUIVALENT_GENERATION_HOURS_MONTH_ARR | [object] | true | 传入的数据 key 值 | ||
| »»» time | string | true | 时间 | ||
| »»» value | number | true | 值 | ||
| »» SEVEN_EQUIVALENT_GENERATION_HOURS_MONTH_ARR | [object] | true | 传入的数据 key 值 | ||
| »» EQUIVALENT_GENERATION_HOURS_MONTH_ARR | [object] | true | 传入的数据 key 值 | ||
| »» EQUIVALENT_GENERATION_HOURS_YEAR_ARR | [object] | true | 传入的数据 key 值 | ||
| »» EQUIVALENT_GENERATION_HOURS_TILL_NOW_ARR | [object] | true | 传入的数据 key 值 | ||
| »» E_POWER_ARR | [object] | true | 传入的数据 key 值 | ||
| »» THREE_E_POWER_ARR | [object] | true | 传入的数据 key 值 | ||
| »» E_AMMETER_MONTH_ARR | [object] | true | 传入的数据 key 值 | ||
| »» E_INTERNET_MONTH_ARR | [object] | true | 传入的数据 key 值 | ||
| »» SEVEN_E_AMMETER_MONTH_ARR | [object] | true | 传入的数据 key 值 | ||
| »» SEVEN_E_INTERNET_MONTH_ARR | [object] | true | 传入的数据 key 值 | ||
| »» E_AMMETER_YEAR_ARR | [object] | true | 传入的数据 key 值 | ||
| »» E_INTERNET_YEAR_ARR | [object] | true | 传入的数据 key 值 | ||
| »» AMMETER_EQUIVALENT_GENERATION_HOURS_ARR | [object] | true | 传入的数据 key 值 | ||
| »» E_AMMETER_DAY_ARR | [object] | true | 传入的数据 key 值 | ||
| »» E_INTERNET_DAY_ARR | [object] | true | 传入的数据 key 值 |
上述key返回结构如下
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"EQUIVALENT_GENERATION_HOURS_MONTH_ARR": [
{
"time": "1",
"value": 2.8705454545454545
}
]
},
"timestamp": 1737705377330
}
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» PLANT_TOTAL_ENERGY | [object] | true | 传入的数据 key 值 | ||
| »»» data | string | true | 数据 | ||
| »»»» deviceId | string | true | 子设备 Id | 如果数据是按设备展示 | |
| »»»» value | string | true | 具体数据 | 如果值是单值 | |
| »»»» dataList | string | true | 具体数据 | 如果值是数组 | |
| »»»»» time | string | true | 时间 | ||
| »»»»» value | string | true | 值 | ||
| »»» deviceList | number | true | 子设备列表 | ||
| »»»» id | number | true | 子设备 Id | ||
| »»»» inverterName | number | true | 子设备名称 | ||
| »»»» inverterSn | number | true | 子设备 sn | ||
| »» EQUIVALENT_SUNSHINE_HOURS | [object] | true | 传入的数据 key 值 | ||
| »» IRRADIANCE | [object] | true | 传入的数据 key 值 | ||
| »» IRRADIANCE_ARR | [object] | true | 传入的数据 key 值 | ||
| »» PLANT_INVERTER_PR_ARR | [object] | true | 传入的数据 key 值 | ||
| »» PLANT_TOTAL_ENERGY | [object] | true | 传入的数据 key 值 | ||
| »» ACTUAL_GENERATION | [object] | true | 传入的数据 key 值 | ||
| »» LOST_GENERATION | [object] | true | 传入的数据 key 值 | ||
| »» THEORETICAL_ACTUAL_GENERATION | [object] | true | 传入的数据 key 值 | ||
| »» PLANT_INVERTER_ENERGY | [object] | true | 传入的数据 key 值 | ||
| »» PLANT_UNIT_AVG_ENERGY | [object] | true | 传入的数据 key 值 |
上述key返回结构如下
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"PLANT_TOTAL_ENERGY": {
"data": [
{
"deviceId": null,
"value": null,
"dataList": [
{
"time": "2025-01-24 13:00:00",
"value": 116.68
}
]
}
],
"deviceList": [
{
"id": 55635,
"inverterSn": "6T2359036555",
"inverterName": "NB_HUAWEI_110K_01"
}
]
}
},
"timestamp": 1737710263083
}
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| »» HOTSPOT_CHART_ARR | [object] | true | 传入的数据 key 值 | ||
| »»» inverterId | string | true | 子设备 Id | ||
| »»» inverterName | number | true | 子设备名称 | ||
| »»» hOTSPOT_CHART_ARR | number | true | 具体数据 | ||
| »»»» time | string | true | 时间 | ||
| »»»» value | number | true | 值 |
上述key返回结构如下
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"HOTSPOT_CHART_ARR": [
{
"hOTSPOT_CHART_ARR": [
{
"time": "2025-01-24 17:10:00",
"value": 0.009100443951370317
}
],
"inverterId": 55635,
"inverterName": "NB_HUAWEI_110K_01"
},
{
"hOTSPOT_CHART_ARR": [
{
"time": "2025-01-24 15:00:00",
"value": 0.23235013788432143
}
],
"inverterId": 55634,
"inverterName": "NB_HUAWEI_110K_02"
}
]
},
"timestamp": 1737705377330
}
太阳能指数图表-发电量
接口描述
通过电站id获取电站的发电量数据
请求方法
/sol_monitor/plant/solarEnergy
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | query | integer | 是 | 电站id |
| year | query | integer | 是 | 年份，例如：2025 |
| X-Access-Token | header | string | 是 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果提示信息 | ||
| » code | integer | true | 响应码 | ||
| » result | object | true | |||
| »» unitGenerationArr | [object] | true | 今年各月份单位发电量图表 | ||
| »»» time | string | true | 月份 | ||
| »»» value | number | true | 月单位发电量值 | ||
| »»» apiValue | null | true | |||
| »»» year | null | true | 年 | ||
| »»» month | null | true | 月 | ||
| »»» day | null | true | 日 | ||
| »»» allDate | null | true | |||
| »»» isnull | null | true | 是否是填补的数据 | null:不是 1:是 | |
| »»» equivalentGenerationHours | null | true | |||
| »» lastYearUnitGenerationArr | [object] | true | 去年各月份单位发电量图表 | ||
| »»» time | string | true | 月份 | ||
| »»» value | integer | true | 单位发电量 | ||
| »»» apiValue | null | true | |||
| »»» year | null | true | |||
| »»» month | null | true | |||
| »»» day | null | true | |||
| »»» allDate | null | true | |||
| »»» isnull | null | true | |||
| »»» equivalentGenerationHours | null | true | |||
| »» solarIndexArr | null | true | 太阳能指数图表 | ||
| »» avgUnitGenerationArr | [object] | true | 平均单位发电量 | 历史所有各月份平均发电量比上电站装机容量图表 | |
| »»» time | string | true | 月份 | ||
| »»» value | number | true | 平均单位发电量 | ||
| »»» apiValue | null | true | |||
| »»» year | null | true | |||
| »»» month | null | true | |||
| »»» day | null | true | |||
| »»» allDate | null | true | |||
| »»» isnull | null | true | |||
| »»» equivalentGenerationHours | null | true | |||
| »» unitGenerationRatioArr | [object] | true | 今年各月单位发电量/去年个月单位发电量图表 | ||
| »»» time | string | true | 值 | ||
| »»» value | integer | true | 月份 | ||
| »»» apiValue | null | true | |||
| »»» year | null | true | |||
| »»» month | null | true | |||
| »»» day | null | true | |||
| »»» allDate | null | true | |||
| »»» isnull | null | true | |||
| »»» equivalentGenerationHours | null | true | |||
| »» unitGenerationValue | number | true | 今年单位发电量 | ||
| »» lastYearUnitGeneration | number | true | 去年单位发电量 | ||
| »» avgUnitGenerationValue | number | true | 平均单位发电量 | ||
| » timestamp | integer | true |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"unitGenerationArr": [
{
"time": "1",
"value": 68.58495352814708,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
}
],
"lastYearUnitGenerationArr": [
{
"time": "1",
"value": 0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
}
],
"solarIndexArr": null,
"avgUnitGenerationArr": [
{
"time": "1",
"value": 34.29247676407354,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
}
],
"unitGenerationRatioArr": [
{
"time": "1",
"value": 0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
}
],
"unitGenerationValue": 68.58495352814708,
"lastYearUnitGeneration": 108.93516979067228,
"avgUnitGenerationValue": 88.76006165940969
},
"timestamp": 1737702852204
}
太阳能指数图表-指数
接口描述
通过电站id获取电站太阳能指数数据
请求方法
/sol_monitor/plant/solarEnergyIndex
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | query | integer | 是 | 电站id |
| year | query | integer | 是 | 年份 |
| X-Access-Token | header | string | 是 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果提示信息 | ||
| » code | integer | true | 响应码 | ||
| » result | object | true | |||
| »» unitGenerationArr | null | true | 今年各月份单位发电量图表 | ||
| »» lastYearUnitGenerationArr | null | true | 今年各月份单位发电量图表 | ||
| »» solarIndexArr | [object] | true | 太阳能指数图表 | ||
| »»» time | string | true | 月份 | ||
| »»» value | number¦null | true | 月太阳能指数值 | ||
| »»» apiValue | null | true | |||
| »»» year | null | true | 年 | ||
| »»» month | null | true | 月 | ||
| »»» day | null | true | 日 | ||
| »»» allDate | null | true | |||
| »»» isnull | null | true | |||
| »» avgUnitGenerationArr | null | true | 历史所有各月份平均发电量比上电站装机容量图表 | ||
| »» unitGenerationRatioArr | null | true | 今年各月单位发电量/去年个月单位发电量图表 | ||
| »» unitGenerationValue | null | true | 今年单位发电量 | ||
| »» lastYearUnitGeneration | null | true | 去年单位发电量 | ||
| »» avgUnitGenerationValue | null | true | 平均单位发电量 | ||
| » timestamp | integer | true | 时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"unitGenerationArr": null,
"lastYearUnitGenerationArr": null,
"solarIndexArr": [
{
"time": "1",
"value": 22.905061615834825,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
}
],
"avgUnitGenerationArr": null,
"unitGenerationRatioArr": null,
"unitGenerationValue": null,
"lastYearUnitGeneration": null,
"avgUnitGenerationValue": null
},
"timestamp": 1737703830812
}
获取电站下逆变器可用性图表
接口描述
根据电站 id、时间颗粒度，获取该电站下所有逆变器对应的对应日/月的可用性数据
请求方法
/sol_monitor/plant/getInverterUsabilityAndUnitPower
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| dataType | query | string | 是 | 日期类型，决定数据聚合的时间范围 |
| datetime | query | string | 是 | 时间，yyyyMMdd 格式 |
| key | query | string | 是 | 图表键 |
| plantId | query | string | 是 | 电站 id |
| x-access-token | header | string | 是 | token |
枚举值
| 属性 | 值 | 说明 |
|---|---|---|
| dataType | DAY | 日，只聚合传入时间日逆变器数据 |
| dataType | MONTH | 月，只聚合传入时间月逆变器数据 |
| key | DAY_USABILITY | 日逆变器可用性 |
| key | MONTH_USABILITY | 月逆变器可用性 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果提示信息 | ||
| » code | integer | true | 响应码 | ||
| » result | List<Map> | true | |||
| »» inverterId | integer | true | 逆变器 id | ||
| »» inverterSn | string | true | 逆变器 sn | ||
| »» inverterName | string | true | 逆变器名称 | ||
| »» DAY_USABILITY | integer | false | 传入日类型图表键和时间，值对应该字段 | ||
| »» MONTH_USABILITY | integer | false | 传入月类型图表键和时间，值对应该字段 | ||
| » timestamp | integer | true | 响应时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": [
{
"inverterId": 55301,
"inverterSn": "2022040237190029",
"inverterName": "NB_JINLANG_230K_01",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.14649666572743
},
{
"inverterId": 55302,
"inverterSn": "202204022A280046",
"inverterName": "NB_JINLANG_230K_02",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.1482577251808
},
{
"inverterId": 55319,
"inverterSn": "202204022A280062",
"inverterName": "NB_JINLANG_230K_03",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.14990138067061
},
{
"inverterId": 55320,
"inverterSn": "202204022A280036",
"inverterName": "NB_JINLANG_230K_04",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.15154503616043
},
{
"inverterId": 55321,
"inverterSn": "202204022A280086",
"inverterName": "NB_JINLANG_230K_05",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.15318869165023
},
{
"inverterId": 55322,
"inverterSn": "202204022A280058",
"inverterName": "NB_JINLANG_230K_06",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.15471494317647
},
{
"inverterId": 55323,
"inverterSn": "202204022B040107",
"inverterName": "NB_JINLANG_230K_07",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.15635859866629
},
{
"inverterId": 55324,
"inverterSn": "202204022A280063",
"inverterName": "NB_JINLANG_230K_08",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.15788485019254
},
{
"inverterId": 55325,
"inverterSn": "202204022A280033",
"inverterName": "NB_JINLANG_230K_09",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.1594111017188
},
{
"inverterId": 55326,
"inverterSn": "202204022A280087",
"inverterName": "NB_JINLANG_230K_10",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.1610547572086
},
{
"inverterId": 55327,
"inverterSn": "202204022B040102",
"inverterName": "NB_JINLANG_230K_11",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 97.16281581666198
},
{
"inverterId": 55328,
"inverterSn": "202204022a280039",
"inverterName": "NB_JINLANG_230K_12",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 98.60394946933408
},
{
"inverterId": 55329,
"inverterSn": "202204022a280034",
"inverterName": "NB_JINLANG_230K_13",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 98.60406687329764
},
{
"inverterId": 55330,
"inverterSn": "202204022a290097",
"inverterName": "NB_JINLANG_230K_14",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 98.6041842772612
},
{
"inverterId": 55331,
"inverterSn": "202204022a280056",
"inverterName": "NB_JINLANG_230K_15",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 98.60430168122475
},
{
"inverterId": 55332,
"inverterSn": "202204022a280057",
"inverterName": "NB_JINLANG_230K_16",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 98.60488870104255
},
{
"inverterId": 55333,
"inverterSn": "202204022b040104",
"inverterName": "NB_JINLANG_230K_17",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 98.60500610500611
},
{
"inverterId": 55334,
"inverterSn": "202204022a280038",
"inverterName": "NB_JINLANG_230K_18",
"DAY_UNIT_POWER": null,
"MONTH_UNIT_POWER": null,
"YEAR_UNIT_POWER": null,
"DAY_USABILITY": null,
"MONTH_USABILITY": 98.60547572086034
}
],
"timestamp": 1737700404654
}
获取逆变器实时/历史数据
接口描述
根据逆变器 id 列表获取逆变器实时/历史数据，根据传入的 type 区分查询历史/实时数据。可以选择是否过滤空的值，过滤则只会返回有值的点位。
请求方法
/sol_monitor/iot/device/data
请求方式
POST
请求参数
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| X-Access-Token | header | string | 是 | token | |
| body | body | object | 否 | ||
| » deviceIdList | body | [long] | 是 | 逆变器 id 列表 | 历史数据只支持查询一个逆变器，传入多 id 也只会查询第一个 |
| » page | body | integer | 是 | 页码 | |
| » pageSize | body | integer | 是 | 大小 | |
| » isFilter | body | boolean | 是 | 是否只看有值 | false：不过滤空值，true：只看有值 |
| » plantId | body | string | 是 | 电站 id | |
| » type | body | integer | 是 | 图表类型 | 0:实时，1:历史 |
| » date | body | string | 否 | 时间 | yyyyMMdd 格式，查询历史数据时需要传入 |
枚举值
| 属性 | 值 | 说明 |
|---|---|---|
| type | 0 | 实时数据 |
| type | 1 | 历史数据 |
| isFilter | true | 过滤空值的点位 |
| isFilter | false | 不过滤空值点位 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果提示信息 | ||
| » code | integer | true | 响应码 | ||
| » result | Map | true | 逆变器点位值列表和点位具体中文名称列表 | ||
| »» data | List<Map> | true | 点位数据 | ||
| »»» InverterSN | string | true | 逆变器 sn | ||
| »»» Datetime | integer | true | 这条数据对应时间戳 | ||
| »» totalPages | integer | true | 总页数 | ||
| »» pageSize | integer | true | 每页显示数量 | ||
| »» page | integer | true | 当前页 | ||
| »» title | List<Map> | true | 点位对应名称列表 | ||
| »»» pointName | string | true | 点位对应名称 | ||
| »»» pointDataName | string | true | 点位 | ||
| »» totalElements | integer | true | 数据总数 | ||
| » timestamp | integer | true | 响应数据的时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"data": [
{
"U_MPPT_15": "0.0",
"U_MPPT_13": "1.4",
"U_MPPT_14": "2.5",
"DataSources": "CollectorCetMsg_R",
"U_MPPT_11": "835.8",
"U_MPPT_12": "831.9",
"U_MPPT_10": "905.4",
"currentDateTime": "2025-01-24 14:15:45",
"IPV1": "1.9",
"U_MPPT_4": "1014.1",
"deviceType": "inverter",
"IPV2": "1.6",
"U_MPPT_5": "1032.2",
"U_MPPT_2": "968.4",
"U_MPPT_3": "1018.6",
"IPV21": "1.9",
"IPV5": "1.8",
"IPV22": "1.6",
"IPV6": "1.6",
"U_MPPT_1": "999.3",
"IPV3": "2.0",
"IPV4": "1.5",
"IPV20": "1.5",
"IPV9": "0.2",
"IPV7": "1.9",
"IPV8": "1.6",
"U_MPPT_8": "842.3",
"U_MPPT_9": "786.8",
"InverterSN": "2022040237190029",
"U_MPPT_6": "674.0",
"U_MPPT_7": "1029.4",
"EDay": "267.1",
"IPV25": "0.0",
"IPV26": "0.0",
"IPV23": "0.0",
"IPV24": "1.6",
"IPV27": "0.0",
"IPV28": "0.0",
"Temperature": "64.9",
"IAC1": "20.6",
"IPV10": "1.4",
"IAC2": "22.4",
"IPV11": "0.1",
"IAC3": "22.1",
"PDC": 30100,
"IPV14": "1.7",
"IPV15": "0.1",
"alarmList": [],
"IPV12": "1.5",
"IPV13": "0.0",
"IPV18": "1.6",
"IPV19": "0.1",
"IPV16": "1.6",
"IPV17": "2.0",
"Datetime": 1737699334,
"CollectorSN": "47TH53",
"FrqAC": "49.97",
"ETotal": "367536.0",
"UAC3": "789.2",
"PowerACOutputActive": 29500,
"UAC2": "790.2",
"UAC1": "786.3"
}
],
"totalPages": 1,
"pageSize": 20,
"page": 1,
"title": [
{
"pointName": "日并网运行时间",
"pointDataName": "D_GT"
},
{
"pointName": "总并网运行时间",
"pointDataName": "T_GT"
},
{
"pointName": "散热片温度",
"pointDataName": "Temperature"
},
{
"pointName": "频率",
"pointDataName": "FrqAC"
},
{
"pointName": "输出功率（交流）",
"pointDataName": "PowerACOutputActive"
},
{
"pointName": "总发电量",
"pointDataName": "ETotal"
},
{
"pointName": "当天发电量",
"pointDataName": "EDay"
},
{
"pointName": "总发电时数",
"pointDataName": "HTotal"
},
{
"pointName": "pv电压1",
"pointDataName": "UPV1"
},
{
"pointName": "pv电压2",
"pointDataName": "UPV2"
},
{
"pointName": "pv电压3",
"pointDataName": "UPV3"
},
{
"pointName": "pv电压4",
"pointDataName": "UPV4"
},
{
"pointName": "pv电压5",
"pointDataName": "UPV5"
},
{
"pointName": "pv电压6",
"pointDataName": "UPV6"
},
{
"pointName": "pv电压7",
"pointDataName": "UPV7"
},
{
"pointName": "pv电压8",
"pointDataName": "UPV8"
},
{
"pointName": "正常运行",
"pointDataName": "Normal_operation"
},
{
"pointName": "采集器SN",
"pointDataName": "CollectorSN"
},
{
"pointName": "逆变器SN",
"pointDataName": "InverterSN"
},
{
"pointName": "采样时间",
"pointDataName": "Datetime"
},
{
"pointName": "pv电压9",
"pointDataName": "UPV9"
},
{
"pointName": "pv电压10",
"pointDataName": "UPV10"
},
{
"pointName": "数据来源",
"pointDataName": "DataSources"
},
{
"pointName": "当前时间",
"pointDataName": "currentDateTime"
},
{
"pointName": "时区",
"pointDataName": "Timezone"
},
{
"pointName": "来源",
"pointDataName": "DBSource"
},
{
"pointName": "状态",
"pointDataName": "State"
},
{
"pointName": "告警编码",
"pointDataName": "Alert"
},
{
"pointName": "pv电压11",
"pointDataName": "UPV11"
},
{
"pointName": "pv电压12",
"pointDataName": "UPV12"
},
{
"pointName": "pv电压13",
"pointDataName": "UPV13"
},
{
"pointName": "pv电压14",
"pointDataName": "UPV14"
},
{
"pointName": "pv电压15",
"pointDataName": "UPV15"
},
{
"pointName": "pv电压16",
"pointDataName": "UPV16"
},
{
"pointName": "A相电压（R）",
"pointDataName": "UAC1"
},
{
"pointName": "B相电压（S）",
"pointDataName": "UAC2"
},
{
"pointName": "C相电压（T）",
"pointDataName": "UAC3"
},
{
"pointName": "B相电流（S）",
"pointDataName": "IAC2"
},
{
"pointName": "C相电流（T）",
"pointDataName": "IAC3"
},
{
"pointName": "输入功率（直流）",
"pointDataName": "PDC"
},
{
"pointName": "pv电流1",
"pointDataName": "IPV1"
},
{
"pointName": "pv电流2",
"pointDataName": "IPV2"
},
{
"pointName": "pv电流3",
"pointDataName": "IPV3"
},
{
"pointName": "pv电流4",
"pointDataName": "IPV4"
},
{
"pointName": "pv电流5",
"pointDataName": "IPV5"
},
{
"pointName": "pv电流6",
"pointDataName": "IPV6"
},
{
"pointName": "pv电流7",
"pointDataName": "IPV7"
},
{
"pointName": "pv电流8",
"pointDataName": "IPV8"
},
{
"pointName": "pv电流9",
"pointDataName": "IPV9"
},
{
"pointName": "pv电流10",
"pointDataName": "IPV10"
},
{
"pointName": "pv电流11",
"pointDataName": "IPV11"
},
{
"pointName": "pv电流12",
"pointDataName": "IPV12"
},
{
"pointName": "pv电流13",
"pointDataName": "IPV13"
},
{
"pointName": "pv电流14",
"pointDataName": "IPV14"
},
{
"pointName": "pv电流15",
"pointDataName": "IPV15"
},
{
"pointName": "pv电流16",
"pointDataName": "IPV16"
},
{
"pointName": "A相电流（R）",
"pointDataName": "IAC1"
},
{
"pointName": "电网过压",
"pointDataName": "OGV"
},
{
"pointName": "日发电小时数",
"pointDataName": "EHtotal"
},
{
"pointName": "设备名称",
"pointDataName": "deviceName"
},
{
"pointName": "pv功率1",
"pointDataName": "Power_PV1"
},
{
"pointName": "pv功率2",
"pointDataName": "Power_PV2"
},
{
"pointName": "pv功率3",
"pointDataName": "Power_PV3"
},
{
"pointName": "pv功率4",
"pointDataName": "Power_PV4"
},
{
"pointName": "pv功率5",
"pointDataName": "Power_PV5"
},
{
"pointName": "pv功率6",
"pointDataName": "Power_PV6"
},
{
"pointName": "pv功率7",
"pointDataName": "Power_PV7"
},
{
"pointName": "pv功率8",
"pointDataName": "Power_PV8"
},
{
"pointName": "pv功率9",
"pointDataName": "Power_PV9"
},
{
"pointName": "pv功率10",
"pointDataName": "Power_PV10"
},
{
"pointName": "pv功率11",
"pointDataName": "Power_PV11"
},
{
"pointName": "pv功率12",
"pointDataName": "Power_PV12"
},
{
"pointName": "pv功率13",
"pointDataName": "Power_PV13"
},
{
"pointName": "pv功率14",
"pointDataName": "Power_PV14"
},
{
"pointName": "pv功率15",
"pointDataName": "Power_PV15"
},
{
"pointName": "pv功率16",
"pointDataName": "Power_PV16"
},
{
"pointName": "pv电压17",
"pointDataName": "UPV17"
},
{
"pointName": "pv电压18",
"pointDataName": "UPV18"
},
{
"pointName": "pv电压19",
"pointDataName": "UPV19"
},
{
"pointName": "pv电压20",
"pointDataName": "UPV20"
},
{
"pointName": "pv电压21",
"pointDataName": "UPV21"
},
{
"pointName": "pv电压22",
"pointDataName": "UPV22"
},
{
"pointName": "pv电压23",
"pointDataName": "UPV23"
},
{
"pointName": "pv电压24",
"pointDataName": "UPV24"
},
{
"pointName": "pv电流17",
"pointDataName": "IPV17"
},
{
"pointName": "pv电流18",
"pointDataName": "IPV18"
},
{
"pointName": "pv电流19",
"pointDataName": "IPV19"
},
{
"pointName": "pv电流20",
"pointDataName": "IPV20"
},
{
"pointName": "pv电流21",
"pointDataName": "IPV21"
},
{
"pointName": "pv电流22",
"pointDataName": "IPV22"
},
{
"pointName": "pv电流23",
"pointDataName": "IPV23"
},
{
"pointName": "pv电流24",
"pointDataName": "IPV24"
},
{
"pointName": "A相频率（R）",
"pointDataName": "A_F"
},
{
"pointName": "B相频率（S）",
"pointDataName": "B_F"
},
{
"pointName": "C相频率（T）",
"pointDataName": "C_F"
},
{
"pointName": "频率1",
"pointDataName": "FraAC1"
},
{
"pointName": "频率2",
"pointDataName": "FraAC2"
},
{
"pointName": "频率3",
"pointDataName": "FraAC3"
},
{
"pointName": "初始待机",
"pointDataName": "Initial_standby"
},
{
"pointName": "控制关机",
"pointDataName": "Controlled_shutdown"
},
{
"pointName": "故障停机",
"pointDataName": "Fault_shutdown"
},
{
"pointName": "待机",
"pointDataName": "Standby"
},
{
"pointName": "降额运行",
"pointDataName": "RCO"
},
{
"pointName": "限额运行",
"pointDataName": "LCO"
},
{
"pointName": "电网AB线电压",
"pointDataName": "U_AC_L1L2"
},
{
"pointName": "电网 BC线电压",
"pointDataName": "U_AC_L2L3"
},
{
"pointName": "电网 CA 线电压",
"pointDataName": "U_AC_L3L1"
},
{
"pointName": "功率因数",
"pointDataName": "COS_PHI"
},
{
"pointName": "MPPT电压1",
"pointDataName": "U_MPPT_1"
},
{
"pointName": "MPPT电压2",
"pointDataName": "U_MPPT_2"
},
{
"pointName": "MPPT电压3",
"pointDataName": "U_MPPT_3"
},
{
"pointName": "MPPT电压4",
"pointDataName": "U_MPPT_4"
},
{
"pointName": "MPPT电压5",
"pointDataName": "U_MPPT_5"
},
{
"pointName": "MPPT电压6",
"pointDataName": "U_MPPT_6"
},
{
"pointName": "MPPT电压7",
"pointDataName": "U_MPPT_7"
},
{
"pointName": "MPPT电压8",
"pointDataName": "U_MPPT_8"
},
{
"pointName": "MPPT电压9",
"pointDataName": "U_MPPT_9"
},
{
"pointName": "MPPT电压10",
"pointDataName": "U_MPPT_10"
},
{
"pointName": "MPPT电压11",
"pointDataName": "U_MPPT_11"
},
{
"pointName": "MPPT电压12",
"pointDataName": "U_MPPT_12"
},
{
"pointName": "MPPT电压13",
"pointDataName": "U_MPPT_13"
},
{
"pointName": "MPPT电压14",
"pointDataName": "U_MPPT_14"
},
{
"pointName": "MPPT电压15",
"pointDataName": "U_MPPT_15"
},
{
"pointName": "MPPT电压16",
"pointDataName": "U_MPPT_16"
},
{
"pointName": "MPPT电流1",
"pointDataName": "I_MPPT_1"
},
{
"pointName": "MPPT电流2",
"pointDataName": "I_MPPT_2"
},
{
"pointName": "MPPT电流3",
"pointDataName": "I_MPPT_3"
},
{
"pointName": "MPPT电流4",
"pointDataName": "I_MPPT_4"
},
{
"pointName": "MPPT电流5",
"pointDataName": "I_MPPT_5"
},
{
"pointName": "MPPT电流6",
"pointDataName": "I_MPPT_6"
},
{
"pointName": "MPPT电流7",
"pointDataName": "I_MPPT_7"
},
{
"pointName": "MPPT电流8",
"pointDataName": "I_MPPT_8"
},
{
"pointName": "MPPT电流9",
"pointDataName": "I_MPPT_9"
},
{
"pointName": "MPPT电流10",
"pointDataName": "I_MPPT_10"
},
{
"pointName": "MPPT电流11",
"pointDataName": "I_MPPT_11"
},
{
"pointName": "MPPT电流12",
"pointDataName": "I_MPPT_12"
},
{
"pointName": "MPPT电流13",
"pointDataName": "I_MPPT_13"
},
{
"pointName": "MPPT电流14",
"pointDataName": "I_MPPT_14"
},
{
"pointName": "MPPT电流15",
"pointDataName": "I_MPPT_15"
},
{
"pointName": "MPPT电流16",
"pointDataName": "I_MPPT_16"
},
{
"pointName": "无功功率",
"pointDataName": "Reactive_power"
},
{
"pointName": "内部温度",
"pointDataName": "Internal_temperature"
},
{
"pointName": "效率",
"pointDataName": "efficiency"
},
{
"pointName": "绝缘阻抗值",
"pointDataName": "Insulation_resistance_value"
},
{
"pointName": "当月发电量",
"pointDataName": "EMon"
},
{
"pointName": "当年发电量",
"pointDataName": "EYear"
},
{
"pointName": "A相功率（R）",
"pointDataName": "A_P"
},
{
"pointName": "B相功率（S）",
"pointDataName": "B_P"
},
{
"pointName": "C相功率（T）",
"pointDataName": "C_P"
},
{
"pointName": "PV空开前电压（直流）",
"pointDataName": "U_DC"
},
{
"pointName": "PV空开后电压（直流）",
"pointDataName": "U_DC1"
},
{
"pointName": "PV电流（直流）",
"pointDataName": "I_DC"
},
{
"pointName": "型号",
"pointDataName": "MODEL"
},
{
"pointName": "序列号13-16位",
"pointDataName": "SERIES"
},
{
"pointName": "序列号9-12位",
"pointDataName": "SERIES1"
},
{
"pointName": "序列号5-8位",
"pointDataName": "SERIES2"
},
{
"pointName": "序列号1-4位",
"pointDataName": "SERIES3"
},
{
"pointName": "控制模式",
"pointDataName": "CONTRAL"
},
{
"pointName": "告警信息",
"pointDataName": "ALARM"
},
{
"pointName": "告警1",
"pointDataName": "AlertArray"
},
{
"pointName": "告警2",
"pointDataName": "AlertArray2"
},
{
"pointName": "告警3",
"pointDataName": "AlertArray3"
},
{
"pointName": "pv电压25",
"pointDataName": "UPV25"
},
{
"pointName": "pv电压26",
"pointDataName": "UPV26"
},
{
"pointName": "pv电压27",
"pointDataName": "UPV27"
},
{
"pointName": "pv电压28",
"pointDataName": "UPV28"
},
{
"pointName": "pv电流25",
"pointDataName": "IPV25"
},
{
"pointName": "pv电流26",
"pointDataName": "IPV26"
},
{
"pointName": "pv电流27",
"pointDataName": "IPV27"
},
{
"pointName": "pv电流28",
"pointDataName": "IPV28"
},
{
"pointName": "pv功率17",
"pointDataName": "Power_PV17"
},
{
"pointName": "pv功率18",
"pointDataName": "Power_PV18"
},
{
"pointName": "pv功率19",
"pointDataName": "Power_PV19"
},
{
"pointName": "pv功率20",
"pointDataName": "Power_PV20"
},
{
"pointName": "pv功率21",
"pointDataName": "Power_PV21"
},
{
"pointName": "pv功率22",
"pointDataName": "Power_PV22"
},
{
"pointName": "pv功率23",
"pointDataName": "Power_PV23"
},
{
"pointName": "pv功率24",
"pointDataName": "Power_PV24"
},
{
"pointName": "pv功率25",
"pointDataName": "Power_PV25"
},
{
"pointName": "pv功率26",
"pointDataName": "Power_PV26"
},
{
"pointName": "pv功率27",
"pointDataName": "Power_PV27"
},
{
"pointName": "pv功率28",
"pointDataName": "Power_PV28"
},
{
"pointName": "pv电压29",
"pointDataName": "UPV29"
},
{
"pointName": "pv电压30",
"pointDataName": "UPV30"
},
{
"pointName": "pv电压31",
"pointDataName": "UPV31"
},
{
"pointName": "pv电压32",
"pointDataName": "UPV32"
},
{
"pointName": "pv电流29",
"pointDataName": "IPV29"
},
{
"pointName": "pv电流30",
"pointDataName": "IPV30"
},
{
"pointName": "pv电流31",
"pointDataName": "IPV31"
},
{
"pointName": "pv电流32",
"pointDataName": "IPV32"
},
{
"pointName": "pv功率29",
"pointDataName": "Power_PV29"
},
{
"pointName": "pv功率30",
"pointDataName": "Power_PV30"
},
{
"pointName": "pv功率31",
"pointDataName": "Power_PV31"
},
{
"pointName": "pv功率32",
"pointDataName": "Power_PV32"
},
{
"pointName": "组串电流1",
"pointDataName": "IDC01"
},
{
"pointName": "组串电流2",
"pointDataName": "IDC02"
},
{
"pointName": "组串电流3",
"pointDataName": "IDC03"
},
{
"pointName": "组串电流4",
"pointDataName": "IDC04"
},
{
"pointName": "组串电流5",
"pointDataName": "IDC05"
},
{
"pointName": "组串电流6",
"pointDataName": "IDC06"
},
{
"pointName": "组串电流7",
"pointDataName": "IDC07"
},
{
"pointName": "组串电流8",
"pointDataName": "IDC08"
},
{
"pointName": "组串电流9",
"pointDataName": "IDC09"
},
{
"pointName": "组串电流10",
"pointDataName": "IDC10"
},
{
"pointName": "组串电流11",
"pointDataName": "IDC11"
},
{
"pointName": "组串电流12",
"pointDataName": "IDC12"
},
{
"pointName": "组串电流13",
"pointDataName": "IDC13"
},
{
"pointName": "组串电流14",
"pointDataName": "IDC14"
},
{
"pointName": "组串电流15",
"pointDataName": "IDC15"
},
{
"pointName": "组串电流16",
"pointDataName": "IDC16"
},
{
"pointName": "组串电流17",
"pointDataName": "IDC17"
},
{
"pointName": "组串电流18",
"pointDataName": "IDC18"
},
{
"pointName": "组串电流19",
"pointDataName": "IDC19"
},
{
"pointName": "组串电流20",
"pointDataName": "IDC20"
},
{
"pointName": "组串电流21",
"pointDataName": "IDC21"
},
{
"pointName": "组串电流22",
"pointDataName": "IDC22"
},
{
"pointName": "组串电流23",
"pointDataName": "IDC23"
},
{
"pointName": "组串电流24",
"pointDataName": "IDC24"
},
{
"pointName": "组串电流25",
"pointDataName": "IDC25"
},
{
"pointName": "组串电流26",
"pointDataName": "IDC26"
},
{
"pointName": "组串电流27",
"pointDataName": "IDC27"
},
{
"pointName": "组串电流28",
"pointDataName": "IDC28"
},
{
"pointName": "组串电流29",
"pointDataName": "IDC29"
},
{
"pointName": "组串电流30",
"pointDataName": "IDC30"
},
{
"pointName": "组串电流31",
"pointDataName": "IDC31"
},
{
"pointName": "组串电流32",
"pointDataName": "IDC32"
},
{
"pointName": "总视在功率",
"pointDataName": "T_APPARENT_POWER"
},
{
"pointName": "保留",
"pointDataName": "retain"
},
{
"pointName": "额定有功功率输出值",
"pointDataName": "RAP"
},
{
"pointName": "额定无功功率输出值",
"pointDataName": "RRP"
},
{
"pointName": "限有功功率调节比例值",
"pointDataName": "LAPRR"
},
{
"pointName": "限无功功率调节比例值",
"pointDataName": "LRPR"
},
{
"pointName": "无功功率值",
"pointDataName": "RPV"
},
{
"pointName": "视在功率值",
"pointDataName": "APV"
},
{
"pointName": "实时功率因素",
"pointDataName": "RTPF"
},
{
"pointName": "限有功功率调节实际值",
"pointDataName": "ALAPRS"
},
{
"pointName": "限无功功率调节实际值",
"pointDataName": "ALAPRO"
},
{
"pointName": "功率因数实际调节值",
"pointDataName": "ALRPR"
},
{
"pointName": "总PV电压",
"pointDataName": "total_UPV"
},
{
"pointName": "总PV电流",
"pointDataName": "total_IPV"
},
{
"pointName": "刷新时间",
"pointDataName": "Refresh_time"
},
{
"pointName": "当前采样时间",
"pointDataName": "Datetime"
},
{
"pointName": "采集器SN",
"pointDataName": "sn"
},
{
"pointName": "设备SN",
"pointDataName": "InverterSN"
},
{
"pointName": "直流母线电压",
"pointDataName": "DC_Busbar_voltage"
},
{
"pointName": "直流母线半电压",
"pointDataName": "Half_voltage_DC_Busbar"
},
{
"pointName": "数据来源",
"pointDataName": "DataSources"
},
{
"pointName": "电网欠压",
"pointDataName": "UGV"
},
{
"pointName": "电网过频",
"pointDataName": "OFR"
},
{
"pointName": "电网欠频",
"pointDataName": "UFR"
},
{
"pointName": "电网阻抗过大",
"pointDataName": "EGI"
},
{
"pointName": "无电网",
"pointDataName": "NG"
},
{
"pointName": "电网不平衡",
"pointDataName": "GB"
},
{
"pointName": "电网频率抖动",
"pointDataName": "GFD"
},
{
"pointName": "电网过流",
"pointDataName": "GOC"
},
{
"pointName": "电网电流跟踪故障",
"pointDataName": "GCTF"
},
{
"pointName": "直流过压",
"pointDataName": "DC_OV"
},
{
"pointName": "直流母线过压",
"pointDataName": "DC_Bus_OV"
},
{
"pointName": "直流母线不均压",
"pointDataName": "DC_Bus_Imb"
},
{
"pointName": "直流母线欠压",
"pointDataName": "DC_Bus_UV"
},
{
"pointName": "直流母线不均压2",
"pointDataName": "DC_Bus_Imb_2"
},
{
"pointName": "直流A路过流",
"pointDataName": "DC_Path_A_OC"
},
{
"pointName": "直流B路过流",
"pointDataName": "DC_Path_B_OC"
},
{
"pointName": "直流输入扰动",
"pointDataName": "DC_Input_Dist"
},
{
"pointName": "电网扰动",
"pointDataName": "Grid_Dist"
},
{
"pointName": "DSP初始化保护",
"pointDataName": "DSP_Init_Prot"
},
{
"pointName": "过温保护",
"pointDataName": "Overtemp_Prot"
},
{
"pointName": "PV绝缘故障",
"pointDataName": "PV_Insul_Fault"
},
{
"pointName": "漏电流保护",
"pointDataName": "Leakage_Curr_Prot"
},
{
"pointName": "Relay检测保护",
"pointDataName": "Relay_Detect_Prot"
},
{
"pointName": "DSP_B保护",
"pointDataName": "DSP_B_Prot"
},
{
"pointName": "直流分量过大",
"pointDataName": "Excessive_DC_Comp"
},
{
"pointName": "12V欠压保护",
"pointDataName": "12V_UV_Prot"
},
{
"pointName": "漏电流自检保护",
"pointDataName": "Leakage_Curr_Self-Check_Prot"
},
{
"pointName": "欠温保护",
"pointDataName": "Undertemp_Prot"
},
{
"pointName": "电弧自检保护",
"pointDataName": "Arc_Self_Check_Prot"
},
{
"pointName": "电弧故障",
"pointDataName": "Arc_Fault"
},
{
"pointName": "预留",
"pointDataName": "Reserved"
},
{
"pointName": "电网扰动02",
"pointDataName": "Grid_disturbance_02"
},
{
"pointName": "电网电流采样异常",
"pointDataName": "Grid_current_abnormal_sampling"
},
{
"pointName": "IGBT过流",
"pointDataName": "IGBT_overcurrent"
},
{
"pointName": "通讯状态",
"pointDataName": "Communication_status"
},
{
"pointName": "上月发电量",
"pointDataName": "LMPP"
},
{
"pointName": "昨日发电量",
"pointDataName": "YDPP"
},
{
"pointName": "去年发电量",
"pointDataName": "LYPP"
},
{
"pointName": "液晶软件版本",
"pointDataName": "LCD_SV"
},
{
"pointName": "标准工作模式",
"pointDataName": "SOM"
},
{
"pointName": "限功率开关",
"pointDataName": "PLS"
},
{
"pointName": "无功调节开关",
"pointDataName": "RPRS"
},
{
"pointName": "绝缘阻抗实时值",
"pointDataName": "RIRV"
},
{
"pointName": "状态",
"pointDataName": "INV_status"
},
{
"pointName": "限有功功率调节_额定功率输出值1",
"pointDataName": "PLR_Rated_Output_Value_1"
},
{
"pointName": "限有功功率调节_额定功率输出值2",
"pointDataName": "PLR_Rated_Output_Value_2"
},
{
"pointName": "逆变器控制字",
"pointDataName": "ICW"
},
{
"pointName": "限功率调节值",
"pointDataName": "PLRV"
},
{
"pointName": "功率因数调节值",
"pointDataName": "PFA"
},
{
"pointName": "限无功功率值",
"pointDataName": "RPLV"
},
{
"pointName": "警告信息故障数据",
"pointDataName": "WMFD"
},
{
"pointName": "初始化接地电压值",
"pointDataName": "IGVV"
},
{
"pointName": "控制离网",
"pointDataName": "CI"
},
{
"pointName": "开环运行",
"pointDataName": "OLO"
},
{
"pointName": "电网浪涌",
"pointDataName": "GS"
},
{
"pointName": "内部风扇故障",
"pointDataName": "IFF"
},
{
"pointName": "电网防雷异常",
"pointDataName": "GLPA"
},
{
"pointName": "外部风扇故障",
"pointDataName": "EFF"
},
{
"pointName": "熔丝异常",
"pointDataName": "FA"
},
{
"pointName": "相线接地告警1",
"pointDataName": "PGA1"
},
{
"pointName": "直流防雷异常",
"pointDataName": "DCLPA"
},
{
"pointName": "电网逆流",
"pointDataName": "Grid_Backflow"
},
{
"pointName": "电网相位异常",
"pointDataName": "GPA"
},
{
"pointName": "直流反接故障",
"pointDataName": "DC_reverse_fault"
},
{
"pointName": "相线接地告警2",
"pointDataName": "PGA2"
},
{
"pointName": "电弧保护",
"pointDataName": "AP"
},
{
"pointName": "告警4",
"pointDataName": "AlertArray4"
},
{
"pointName": "预警1",
"pointDataName": "WarnArray"
},
{
"pointName": "预警2",
"pointDataName": "WarnArray2"
},
{
"pointName": "预警3",
"pointDataName": "WarnArray3"
},
{
"pointName": "预警4",
"pointDataName": "WarnArray4"
},
{
"pointName": "状态1",
"pointDataName": "StatusArray"
},
{
"pointName": "状态2",
"pointDataName": "StatusArray2"
},
{
"pointName": "状态3",
"pointDataName": "StatusArray3"
},
{
"pointName": "状态4",
"pointDataName": "StatusArray4"
},
{
"pointName": "序列号1",
"pointDataName": "SERIES"
},
{
"pointName": "序列号2",
"pointDataName": "SERIES2"
},
{
"pointName": "序列号3",
"pointDataName": "SERIES3"
},
{
"pointName": "序列号4",
"pointDataName": "SERIES4"
},
{
"pointName": "状态1",
"pointDataName": "WarnArray"
},
{
"pointName": "状态2",
"pointDataName": "WarnArray2"
},
{
"pointName": "状态3",
"pointDataName": "WarnArray3"
},
{
"pointName": "状态4",
"pointDataName": "WarnArray4"
},
{
"pointName": "预警1",
"pointDataName": "StatusArray"
},
{
"pointName": "预警2",
"pointDataName": "StatusArray2"
},
{
"pointName": "预警3",
"pointDataName": "StatusArray3"
},
{
"pointName": "预警4",
"pointDataName": "StatusArray4"
},
{
"pointName": "故障1",
"pointDataName": "AlertArray"
},
{
"pointName": "故障2",
"pointDataName": "AlertArray2"
},
{
"pointName": "故障3",
"pointDataName": "AlertArray3"
},
{
"pointName": "故障4",
"pointDataName": "AlertArray4"
},
{
"pointName": "设备地址",
"pointDataName": "LogicAddr"
},
{
"pointName": "告警5",
"pointDataName": "AlertArray5"
},
{
"pointName": "设备型号",
"pointDataName": "Model"
},
{
"pointName": "MPPT电流17",
"pointDataName": "I_MPPT_17"
},
{
"pointName": "MPPT电流18",
"pointDataName": "I_MPPT_18"
},
{
"pointName": "MPPT电流19",
"pointDataName": "I_MPPT_19"
},
{
"pointName": "MPPT电流20",
"pointDataName": "I_MPPT_20"
},
{
"pointName": "保留1",
"pointDataName": "retain1"
},
{
"pointName": "不转换",
"pointDataName": "sampleVariableName"
},
{
"pointName": "不转换1",
"pointDataName": "sampleVariableName1"
},
{
"pointName": "不转换2",
"pointDataName": "sampleVariableName2"
},
{
"pointName": "不转换3",
"pointDataName": "sampleVariableName3"
},
{
"pointName": "不转换4",
"pointDataName": "sampleVariableName4"
},
{
"pointName": "不转换5",
"pointDataName": "sampleVariableName5"
},
{
"pointName": "不转换6",
"pointDataName": "sampleVariableName6"
},
{
"pointName": "不转换7",
"pointDataName": "sampleVariableName7"
},
{
"pointName": "不转换8",
"pointDataName": "sampleVariableName8"
},
{
"pointName": "不转换9",
"pointDataName": "sampleVariableName9"
},
{
"pointName": "不转换10",
"pointDataName": "sampleVariableName10"
},
{
"pointName": "告警1",
"pointDataName": "Alarm1"
},
{
"pointName": "告警2",
"pointDataName": "Alarm2"
},
{
"pointName": "告警3",
"pointDataName": "Alarm3"
},
{
"pointName": "告警4",
"pointDataName": "Alarm4"
},
{
"pointName": "告警5",
"pointDataName": "Alarm5"
}
],
"totalElements": 1
},
"timestamp": 1737699593295
}
电站模拟图表数据
接口描述
通过指定日期，电站 id 和图表数据类型，获取电站模拟图表数据
请求方法
/sol_monitor/iot/plantSimulation
请求方式
POST
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| »x-access-token | header | string | 是 | token |
| »body | body | object | 是 | 请求体 |
| »»plantId | body | long | 是 | 电站 id |
| »»date | body | string | 是 | 日期，格式为年-月-日，例如 2024-12-10 |
| »»keyList | body | [string] | 是 | 图表 key 列表 |
| »»isNow | body | integer | 否 | 0：否，1：是 （7 日图表需要传入） |
Body 请求示例
{
"date": "20250124",
"plantId": "43335",
"isNow": 1,
"keyList": ["PLANT_PR_AMMETER_MONTH_ARR", "SEVEN_PLANT_PR_AMMETER_MONTH_ARR"]
}
key 枚举值
| 属性 | 值 | 说明 |
|---|---|---|
| keyList | PLANT_PR_INVERTER_MONTH_ARR | 逆变器 pr 月图表 |
| keyList | PLANT_PR_INVERTER_YEAR_ARR | 逆变器 pr 年图表 |
| keyList | PLANT_PR_AMMETER_MONTH_ARR | 电表 pr 月图表 |
| keyList | PLANT_PR_AMMETER_YEAR_ARR | 电表 pr 年图表 |
| keyList | SEVEN_PLANT_PR_AMMETER_MONTH_ARR | 电表 pr 7 天图表 |
| keyList | IRRADIANCE_MONTH_ARR | 辐照量月图表 |
| keyList | IRRADIANCE_YEAR_ARR | 辐照量年图表 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 成功标志 | ||
| » message | string | true | 处理消息 | ||
| » code | integer | true | 响应状态码 | ||
| » result | object | true | 数据对象 | ||
| »» irradiatorName | string | false | 辐照仪名称 | ||
| »» IRRADIANCE_YEAR_ARR | [object] | false | 电站模拟图表 key | 例如：传入什么 key 值，就返回什么 key 值 | |
| »»» time | string | true | 聚合粒度具体时间 | 7 天：日，月：日，年：月，总：年 | |
| »»» value | number¦null | true | 值 | 时间点对应的值 | |
| »»» apiValue | number¦null | true | |||
| »»» year | integer | true | 年 | ||
| »»» month | integer | true | 月 | ||
| »»» day | null | true | 日 | ||
| » timestamp | integer | true | 时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"irradiatorName": "浙江嘉兴（恒为）",
"SEVEN_PLANT_PR_AMMETER_MONTH_ARR": [
{
"time": "18",
"value": 0.8267701953196162,
"apiValue": null,
"year": 2025,
"month": 1,
"day": null,
"allDate": null,
"isnull": null,
"readingOne": null,
"readingTwo": null,
"readingThree": null,
"readingFour": null,
"lastDataUpdateTime": null,
"selfUseRatio": null,
"abnormal": null,
"equivalentGenerationHours": null
},
{
"time": "19",
"value": 0.8114098622615421,
"apiValue": null,
"year": 2025,
"month": 1,
"day": null,
"allDate": null,
"isnull": null,
"readingOne": null,
"readingTwo": null,
"readingThree": null,
"readingFour": null,
"lastDataUpdateTime": null,
"selfUseRatio": null,
"abnormal": null,
"equivalentGenerationHours": null
},
{
"time": "20",
"value": 1.0063425680813725,
"apiValue": null,
"year": 2025,
"month": 1,
"day": null,
"allDate": null,
"isnull": null,
"readingOne": null,
"readingTwo": null,
"readingThree": null,
"readingFour": null,
"lastDataUpdateTime": null,
"selfUseRatio": null,
"abnormal": null,
"equivalentGenerationHours": null
},
{
"time": "21",
"value": 0.8002699110200724,
"apiValue": null,
"year": 2025,
"month": 1,
"day": null,
"allDate": null,
"isnull": null,
"readingOne": null,
"readingTwo": null,
"readingThree": null,
"readingFour": null,
"lastDataUpdateTime": null,
"selfUseRatio": null,
"abnormal": null,
"equivalentGenerationHours": null
},
{
"time": "22",
"value": 1.1993279194186754,
"apiValue": null,
"year": 2025,
"month": 1,
"day": null,
"allDate": null,
"isnull": null,
"readingOne": null,
"readingTwo": null,
"readingThree": null,
"readingFour": null,
"lastDataUpdateTime": null,
"selfUseRatio": null,
"abnormal": null,
"equivalentGenerationHours": null
},
{
"time": "23",
"value": 0.643304299314959,
"apiValue": null,
"year": 2025,
"month": 1,
"day": null,
"allDate": null,
"isnull": null,
"readingOne": null,
"readingTwo": null,
"readingThree": null,
"readingFour": null,
"lastDataUpdateTime": null,
"selfUseRatio": null,
"abnormal": null,
"equivalentGenerationHours": null
},
{
"time": "24",
"value": 0.6191382354330134,
"apiValue": null,
"year": 2025,
"month": 1,
"day": null,
"allDate": null,
"isnull": null,
"readingOne": null,
"readingTwo": null,
"readingThree": null,
"readingFour": null,
"lastDataUpdateTime": null,
"selfUseRatio": null,
"abnormal": null,
"equivalentGenerationHours": null
}
]
},
"timestamp": 1737699078568
}
获取电站天气卡片
接口描述
通过指定电站获取该电站天气卡片信息
请求方法
/sol_monitor/common/getWeatherCard
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | query | string | 否 | 电站 id |
| wordType | query | string | 否 | 非必填 |
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果的提示消息 | ||
| » code | integer | true | 请求状态码 | ||
| » result | object | true | 天气信息数据 | ||
| »» weatherDailyList | [object] | true | 电站最近的天气 | ||
| »»» createTime | string | true | 创建时间 | ||
| »»» updateTime | string | true | 修改时间 | ||
| »»» locationId | string | true | 地区 id | ||
| »»» fxTime | string | true | 预报日期 | ||
| »»» sunrise | integer | true | 日出时间戳 | ||
| »»» sunset | integer | true | 日落时间戳 | ||
| »»» moonrise | string | true | 月升时间 | ||
| »»» moonset | string | true | 月落时间 | ||
| »»» moonPhase | string | true | 月相名称 | ||
| »»» tempMax | string | true | 预报当天最高温度 | ||
| »»» tempMin | string | true | 预报当天最低温度 | ||
| »»» iconDay | string | true | 预报白天天气状况的图标代码 | ||
| »»» textDay | string | true | 预报白天天气状况文字描述 | ||
| »»» iconNight | string | true | 预报夜间天气状况的图标代码 | ||
| »»» textNight | string | true | 预报晚间天气状况文字描述 | ||
| »» wheatherHourly | object | true | 当天天气情况 | ||
| »»» id | integer | true | id | ||
| »»» createTime | string | true | 创建时间 | ||
| »»» updateTime | string | true | 修改时间 | ||
| »»» locationId | string | true | 地区 ID | ||
| »»» fxTime | string | true | 预报日期 | ||
| »»» temp | string | true | 温度 | ||
| »»» icon | string | true | 天气状况和图标的代码 | ||
| »»» text | string | true | 天气状况的文字描述 | ||
| »»» hour | integer | true | 当日几点 | ||
| »»» sunRise | integer | true | 日出时间戳 | ||
| »»» sunSet | integer | true | 日落时间戳 | ||
| » timestamp | integer | true | 响应数据的时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"weatherDailyList": [
{
"id": 46102,
"createTime": "2025-01-23",
"updateTime": "2025-01-23 17:00:52",
"locationId": "101020900",
"fxTime": "2025-01-23",
"sunrise": 1737586320000,
"sunset": 1737624180000,
"moonrise": "01:09",
"moonset": "11:50",
"moonPhase": "残月",
"tempMax": "16",
"tempMin": "8",
"iconDay": "101",
"textDay": "多云",
"iconNight": "104",
"textNight": "阴",
"wind360Day": "0",
"windDirDay": "北风",
"windScaleDay": "1-3",
"windSpeedDay": "3",
"wind360Night": "0",
"windScaleNight": "1-3",
"windSpeedNight": "3",
"humidity": "88",
"precip": "0.0",
"pressure": "1021",
"vis": "24",
"cloud": "25",
"uvIndex": "2",
"windDirNight": "北风"
}
],
"wheatherHourly": {
"id": 1575016,
"createTime": "2025-01-24",
"updateTime": "2025-01-24 13:00:50",
"locationId": "101020900",
"fxTime": "2025-01-24T16:00+08:00",
"temp": "13",
"icon": "101",
"text": "多云",
"wind360": "61",
"windDir": "东北风",
"windScale": "3-4",
"windSpeed": "20",
"humidity": "62",
"precip": "0.0",
"pressure": "1024",
"pop": "7",
"cloud": "54",
"dew": "5",
"hour": 16,
"sunRise": 1737672720000,
"sunSet": 1737710580000,
"sunRiseTime": "2025-01-24 06:52:00",
"sunSetTime": "2025-01-24 17:23:00"
}
},
"timestamp": 1737706664656
}
获取电站每月天气
接口描述
通过日期、电站 ID 获取该日期所在月份一整个月的天气。
请求方法
/sol_monitor/common/getMonthlyWeather
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | query | string | 否 | 电站 id |
| dateTime | query | string | 否 | 要查询的日期 |
| wordType | query | string | 否 | 非必填 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果的提示消息 | ||
| » code | integer | true | 请求状态码 | ||
| » result | [object] | true | 当月电站天气 | ||
| »» createTime | string | true | 创建时间 | ||
| »» updateTime | string | true | 修改时间 | ||
| »» locationId | string | true | 地区 id | ||
| »» fxTime | string | true | 预报时间 | ||
| »» sunrise | integer | true | 日出时间戳 | ||
| »» sunset | integer | true | 日落时间戳 | ||
| »» moonrise | string | true | 月升时间 | ||
| »» moonset | string | true | 月落时间 | ||
| »» tempMax | string | true | 预报当天最高温度 | ||
| »» tempMin | string | true | 预报当天最低温度 | ||
| »» iconDay | string | true | 预报白天天气状况的图标代码 | ||
| »» textDay | string | true | 预报白天天气状况文字描述 | ||
| »» iconNight | string | true | 预报夜间天气状况的图标代码 | ||
| »» textNight | string | true | 预报晚间天气状况文字描述 | ||
| » timestamp | integer | true | 响应数据的时间戳 |
返回示例
{
"success": true,
"message": "string",
"code": 0,
"result": [
{
"createTime": "string",
"updateTime": "string",
"locationId": "string",
"fxTime": "string",
"sunrise": 0,
"sunset": 0,
"moonrise": "string",
"moonset": "string",
"tempMax": "string",
"tempMin": "string",
"iconDay": "string",
"textDay": "string",
"iconNight": "string",
"textNight": "string"
}
],
"timestamp": 0
}
接口描述
通过指定的电站 id,获取到电站详情信息。
请求方法
/sol_monitor/plant/{plantId}
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | path | string | 是 | 电站 id |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果的提示消息 | ||
| » code | integer | true | 请求状态码 | ||
| » result | object | true | 具体的电站信息 | ||
| »» OperationOwner | object | true | 电站持有信息 | ||
| »»» id | integer | true | 电站 id | ||
| »»» createTime | string | true | 电站创建时间 | ||
| »»» updateTime | string | true | 电站信息修改时间 | ||
| »»» plantId | integer | true | 电站 id | ||
| »»» stationMaster | string | true | 电站运维信息-电站站长 | ||
| »»» dutyPhone | string | true | 电站运维信息-电站值班电话 | ||
| »»» operationMethod | string | true | 电站运维信息-电站运维方式:0 自运维 1 第三方运维 | ||
| »»» operationCompany | string | true | 电站运维信息-运维公司 | ||
| »»» projectCompant | string | true | 电站持有信息-所属项目公司 | ||
| »»» holder | string | true | 电站持有信息-所属持有人 | ||
| »»» ownerContactInfomation | string | true | 电站持有信息-电站联系方式 | ||
| »»» createTime | string | true | 电站创建时间 | ||
| »»» updateTime | string | true | 电站修改时间 | ||
| »»» locationId | string | true | 电站地址 id | ||
| »»» communicationStatus | integer | true | 通信状态 1：离线 2：部分离线 3：正常 | ||
| »»» alarmStatus | integer | true | 告警状态（1：运行，2：停机，3：预警，4：故障） | ||
| »»» lastAlarmStatus | integer | true | 上一条告警状态（1：健康，2：预警，3：故障，4：离线） | ||
| »»» powerNow | string | true | 当前发电功率 | ||
| »»» yesterdayEday | number | true | 昨日发电量 | ||
| »»» yesterdayAmmeterEday | integer | true | 昨日电表发电量 | ||
| »»» powerAll | integer | true | 电站容量 | ||
| »»» gridConnectionTime | string | true | 并网时间 | ||
| »»» address | string | true | 电站详细地址 | ||
| »»» plantName | string | true | 电站名称 | ||
| »»» plantSpell | string | true | 电站拼音 | ||
| »»» plantStatus | integer | true | 电站状态（1：离线，2：运行，3：异常） | ||
| »»» plantType | string | true | 电站类型 | ||
| »»» longitude | string | true | 经度 | ||
| »»» latitude | string | true | 纬度 | ||
| »»» plantImage | string | true | 电站图片 | ||
| »»» province | string | true | 省份 | ||
| »»» city | string | true | 市 | ||
| »»» area | string | true | 区 | ||
| »»» provinceId | string | true | 省份 id | ||
| »»» cityId | string | true | 市级 id | ||
| »»» areaId | string | true | 区级 id | ||
| »»» plantAnalysisStatus | integer | true | 电站分析状态(0:正常发电,1：发电异常) | ||
| »»» plantGenerationTime | number | true | 等效发电小时 | ||
| »»» plantWeather | string | true | 电站天气 | ||
| »»» plantTemperature | string | true | 电站温度 | ||
| »»» componentInclination | integer | true | 组件倾角 | ||
| »»» billingTemplate | null | true | 计费模版 | ||
| »»» internetMode | string | true | 上网模式 | ||
| »»» dataSources | string | true | 数据来源 | ||
| »»» gridConnectedCapacity | integer | true | 电站并网总量 | ||
| »»» dataConnectionTime | string | true | 数据录入时间 | ||
| »»» gridConnectionTimeType | string | true | 并网时间类型 0:数据录入时间 1:手动选择 | ||
| »»» offLineDayDeviceCount | integer | true | 离线超过 24 小时设备数量 | ||
| »»» allName | string | true | 电站名称 | ||
| »»» arrayModelName | string | true | 电站组件型号 | ||
| »»» arrayModelId | number | true | 电站组件型号 id | ||
| »»» gridConnectionCompany | string | true | 并网公司 | ||
| »»» gridConnectionLevel | null | true | 并网等级 | ||
| »» dataSourceList | [object] | true | 电站数据来源 | ||
| »»» parentId | integer | false | 混合数据、接口数据、采集器数据 | ||
| »»» name | string | false | 数据来源名称 | ||
| »»» tagId | integer | false | 标签 ID | ||
| »»» plantId | integer | false | 电站 ID | ||
| »»» tagName | string | false | 标签名称 | ||
| » timestamp | integer | true | 响应数据的时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"OperationOwner": {
"id": 727,
"createTime": "2023-04-20 14:00:36",
"updateTime": "2023-04-20 15:23:42",
"plantId": 43220,
"stationMaster": "",
"dutyPhone": "",
"operationMethod": "",
"operationCompany": "",
"projectCompant": "",
"holder": "",
"ownerContactInfomation": ""
},
"plant": {
"id": 43220,
"createTime": "2023-04-20 14:00:35",
"updateTime": "2025-01-09 14:56:47",
"customerName": null,
"jeecgPlantId": null,
"locationId": "101020500",
"tenant": null,
"tenantPhone": null,
"communicationStatus": 3,
"alarmStatus": 1,
"lastAlarmStatus": 1,
"powerNow": "638.068",
"yesterdayEday": 5622.3,
"yesterdayAmmeterEday": 5480,
"powerAll": 3600,
"gridConnectionTime": "2023-03-31",
"address": "安亭镇园国路1188号",
"plantName": "*新纺联",
"plantSpell": "*xinfanglian",
"income": null,
"plantStatus": 3,
"plantType": "1",
"longitude": "121.183610",
"latitude": "31.327771",
"userId": null,
"isConnect": null,
"plantImage": "temp/新纺联_1693545859584.jpg",
"country": "",
"province": "上海",
"city": "上海",
"area": "嘉定",
"provinceId": "310000",
"cityId": "310100",
"areaId": "310114",
"timezone": null,
"lastDataTimestamp": null,
"systemType": null,
"areaNumber": null,
"areaName": null,
"customerNumber": null,
"accessStatus": null,
"goodWeId": null,
"plantAnalysisStatus": 1,
"plantGenerationTime": 0.944444,
"plantWeather": "多云",
"plantTemperature": "13",
"powerArr": null,
"componentInclination": 15,
"billingTemplate": null,
"internetMode": "0",
"dataSources": "3",
"icon": "101",
"energyCalc": 1,
"actualCapacity": 3600,
"gridConnectedCapacity": 3600,
"benchmarkFlag": null,
"delFlag": null,
"lastPerWatt": 1.56175,
"dataConnectionTime": "2023-05-23 10:58:49",
"gridConnectionTimeType": "1",
"offLineDayDeviceCount": 0,
"emqxBrandAreaId": null,
"focus": null,
"allName": "*新纺联3.6MWp工商业电站",
"haveInverter": 18,
"haveAmmeter": 2,
"haveGateWayAmmeter": 1,
"templateModel": null,
"plantImg": null,
"dataAccessId": null,
"dataModelId": null,
"dataModelName": null,
"componentCount": null,
"usabilitySource": null,
"isDeduct": 1,
"templateMethod": 1,
"offlineStartDate": null,
"adjusting": null,
"adjustingContract": 0,
"arrayBrandId": 1746,
"arrayBrandName": "晶科JINKO",
"keyId": null,
"arrayModelId": 188,
"arrayModelName": "JKM550M-72HL4-V",
"platformAccessTime": null,
"usedEnergyPercentage": 0.99,
"gridConnectionCompany": "",
"gridConnectionLevel": null,
"onlinePriceId": null,
"assetManageConfigFlag": 1,
"usabilityRange": "85.0-95.0",
"energySourceType": 0,
"plantEnergy": null,
"activePower": null,
"chargeEDay": null,
"dischargeEDay": null,
"soc": null,
"pr": 0.51,
"irradiance": 1.46,
"socArr": null,
"incomePermission": null,
"operatorTeamName": null,
"calcPowerAll": null,
"operatorDateRange": null,
"serviceName": "全部",
"serviceEndTime": "2028-02-29",
"hasQuota": 1,
"virtualAmmeterIdList": null,
"eammeterMonth": "196400.0",
"eammeterYear": "196400.0",
"eammeterTotal": "7420400.0",
"emonth": "201617.6",
"eyear": "201617.59999999995",
"etotal": "6666065.8",
"eday": 3562.4,
"eammeterDay": 3400,
"edayNum": null
},
"isNewDevice": 0,
"dataSourceList": [
{
"id": 3,
"parentId": 0,
"createTime": "2022-07-13 15:48:42",
"name": "混合数据",
"apiUrl": ""
}
],
"tags": [
{
"tagId": 49,
"plantId": 43220,
"tagName": "机器人",
"userId": "1645735968938299393"
}
]
},
"timestamp": 1737695827385
}
获取逆变器组串发电量图表
接口描述
逆变器下组串日发电量 入参 keyList 可选(可多选)的参数： IAC 交流电流,UAC 交流电压,IPV 直流电流,UPV 直流电压,IMPPT mppt 电流,UMPPT mppt 电压,ARRAY_POWER_ARR 直流侧组串功率,AC_ARRAY_POWER_ARR,交流侧组串功率
请求方法
/sol_monitor/iot/array
请求方式
POST
请求参数
{
"date": "20250124",
"deviceId": 57060,
"keyList": ["IMPPT"]
}
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 成功标志 | ||
| » message | string | true | 返回消息 | ||
| » code | integer | true | 返回状态码 | ||
| » result | [object] | true | 结果体 | ||
| »» IMPPT1 | string | false | IMPPT1 电流数组 | ||
| »» IMPPT2 | string | false | IMPPT2 电流数组 | ||
| »» IMPPT3 | string | false | IMPPT3 电流数组 | ||
| »» IMPPT4 | string | false | IMPPT4 电流数组 | ||
| »» IMPPT5 | string | false | IMPPT5 电流数组 | ||
| »» IMPPT6 | string | false | IMPPT6 电流数组 | ||
| »» IMPPT7 | string | false | IMPPT7 电流数组 | ||
| »» IMPPT8 | string | false | IMPPT8 电流数组 | ||
| »» IMPPT9 | string | false | IMPPT9 电流数组 | ||
| » timestamp | integer | true | 接口响应时间戳 |
返回示例
{
"success": true,
"message": "string",
"code": 0,
"result": [
{
"IMPPT1": "string",
"IMPPT2": "string",
"IMPPT3": "string",
"IMPPT4": "string",
"IMPPT5": "string",
"IMPPT6": "string",
"IMPPT7": "string",
"IMPPT8": "string",
"IMPPT9": "string"
}
],
"timestamp": 0
}
逆变器设备的聚合图表数据
接口描述
通过指定日期，逆变器 id 和图表数据类型，获取逆变器设备的聚合图表数据
请求方法
/sol_monitor/iot/device
请求方式
POST
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| »x-access-token | header | string | 是 | token |
| »body | body | object | 是 | 请求体 |
| »»deviceId | body | long | 是 | 逆变器 id |
| »»date | body | string | 是 | 日期，格式为年-月-日，例如 2024-12-10 |
| »»keyList | body | [string] | 是 | 图表 key 列表 |
key 枚举值
| 属性 | 值 | 说明 |
|---|---|---|
| keyList | E_DAY_ARR | 发电量图表 |
| keyList | E_POWER_ARR | 输出交流功率图表 |
| keyList | E_POWER_IN_DC_ARR | 输入直流功率图表 |
| keyList | TEMPERATURE | 设备温度图表 |
| keyList | ARRAY_HOTSPOT_CHART_ARR | 组串热点图表 |
Body 请求示例
{
"date": "20250124",
"deviceId": 56118,
"keyList": ["E_DAY_ARR"]
}
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 成功标志 | ||
| » message | string | true | 处理消息 | ||
| » code | integer | true | 响应状态码 | ||
| » result | object | true | 数据对象 | ||
| »» inverterSN | string | true | 逆变器 SN | ||
| »» E_DAY_ARR | [object] | false | 逆变器图表 key | 例如：传入的是 E_DAY_ARR，则返回 E_DAY_ARR) | |
| »»» time | string | true | 日期 | 类型：yyyy-MM-dd HH:mm:ss | |
| »»» value | number¦null | true | 值 | 时间点对应的值 | |
| »»» apiValue | number¦null | true | |||
| »»» year | integer | true | 日 | ||
| »»» month | integer | true | 月 | ||
| »»» day | null | true | 年 | ||
| » timestamp | integer | true | 时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"E_DAY_ARR": "[{\"time\":\"2025-01-24 00:00:00\"},{\"time\":\"2025-01-24 00:05:00\"},{\"time\":\"2025-01-24 00:10:00\"},{\"time\":\"2025-01-24 00:15:00\"},{\"time\":\"2025-01-24 00:20:00\"},{\"time\":\"2025-01-24 00:25:00\"},{\"time\":\"2025-01-24 00:30:00\"},{\"time\":\"2025-01-24 00:35:00\"},{\"time\":\"2025-01-24 00:40:00\"},{\"time\":\"2025-01-24 00:45:00\"},{\"time\":\"2025-01-24 00:50:00\"},{\"time\":\"2025-01-24 00:55:00\"},{\"time\":\"2025-01-24 01:00:00\"},{\"time\":\"2025-01-24 01:05:00\"},{\"time\":\"2025-01-24 01:10:00\"},{\"time\":\"2025-01-24 01:15:00\"},{\"time\":\"2025-01-24 01:20:00\"},{\"time\":\"2025-01-24 01:25:00\"},{\"time\":\"2025-01-24 01:30:00\"},{\"time\":\"2025-01-24 01:35:00\"},{\"time\":\"2025-01-24 01:40:00\"},{\"time\":\"2025-01-24 01:45:00\"},{\"time\":\"2025-01-24 01:50:00\"},{\"time\":\"2025-01-24 01:55:00\"},{\"time\":\"2025-01-24 02:00:00\"},{\"time\":\"2025-01-24 02:05:00\"},{\"time\":\"2025-01-24 02:10:00\"},{\"time\":\"2025-01-24 02:15:00\"},{\"time\":\"2025-01-24 02:20:00\"},{\"time\":\"2025-01-24 02:25:00\"},{\"time\":\"2025-01-24 02:30:00\"},{\"time\":\"2025-01-24 02:35:00\"},{\"time\":\"2025-01-24 02:40:00\"},{\"time\":\"2025-01-24 02:45:00\"},{\"time\":\"2025-01-24 02:50:00\"},{\"time\":\"2025-01-24 02:55:00\"},{\"time\":\"2025-01-24 03:00:00\"},{\"time\":\"2025-01-24 03:05:00\"},{\"time\":\"2025-01-24 03:10:00\"},{\"time\":\"2025-01-24 03:15:00\"},{\"time\":\"2025-01-24 03:20:00\"},{\"time\":\"2025-01-24 03:25:00\"},{\"time\":\"2025-01-24 03:30:00\"},{\"time\":\"2025-01-24 03:35:00\"},{\"time\":\"2025-01-24 03:40:00\"},{\"time\":\"2025-01-24 03:45:00\"},{\"time\":\"2025-01-24 03:50:00\"},{\"time\":\"2025-01-24 03:55:00\"},{\"time\":\"2025-01-24 04:00:00\"},{\"time\":\"2025-01-24 04:05:00\"},{\"time\":\"2025-01-24 04:10:00\"},{\"time\":\"2025-01-24 04:15:00\"},{\"time\":\"2025-01-24 04:20:00\"},{\"time\":\"2025-01-24 04:25:00\"},{\"time\":\"2025-01-24 04:30:00\"},{\"time\":\"2025-01-24 04:35:00\"},{\"time\":\"2025-01-24 04:40:00\"},{\"time\":\"2025-01-24 04:45:00\"},{\"time\":\"2025-01-24 04:50:00\"},{\"time\":\"2025-01-24 04:55:00\"},{\"time\":\"2025-01-24 05:00:00\"},{\"time\":\"2025-01-24 05:05:00\"},{\"time\":\"2025-01-24 05:10:00\"},{\"time\":\"2025-01-24 05:15:00\"},{\"time\":\"2025-01-24 05:20:00\"},{\"time\":\"2025-01-24 05:25:00\"},{\"time\":\"2025-01-24 05:30:00\"},{\"time\":\"2025-01-24 05:35:00\"},{\"time\":\"2025-01-24 05:40:00\"},{\"time\":\"2025-01-24 05:45:00\"},{\"time\":\"2025-01-24 05:50:00\"},{\"time\":\"2025-01-24 05:55:00\"},{\"time\":\"2025-01-24 06:00:00\"},{\"time\":\"2025-01-24 06:05:00\"},{\"time\":\"2025-01-24 06:10:00\"},{\"time\":\"2025-01-24 06:15:00\"},{\"time\":\"2025-01-24 06:20:00\"},{\"time\":\"2025-01-24 06:25:00\"},{\"time\":\"2025-01-24 06:30:00\"},{\"time\":\"2025-01-24 06:35:00\"},{\"time\":\"2025-01-24 06:40:00\"},{\"time\":\"2025-01-24 06:45:00\"},{\"time\":\"2025-01-24 06:50:00\"},{\"time\":\"2025-01-24 06:55:00\",\"value\":0.02},{\"time\":\"2025-01-24 07:00:00\",\"value\":0.07},{\"time\":\"2025-01-24 07:05:00\",\"value\":0.19},{\"time\":\"2025-01-24 07:10:00\",\"value\":0.37},{\"time\":\"2025-01-24 07:15:00\",\"value\":0.6},{\"time\":\"2025-01-24 07:20:00\",\"value\":0.9},{\"time\":\"2025-01-24 07:25:00\",\"value\":1.3},{\"time\":\"2025-01-24 07:30:00\",\"value\":1.78},{\"time\":\"2025-01-24 07:35:00\",\"value\":2.3},{\"time\":\"2025-01-24 07:40:00\",\"value\":2.79},{\"time\":\"2025-01-24 07:45:00\",\"value\":3.22},{\"time\":\"2025-01-24 07:50:00\",\"value\":3.59},{\"time\":\"2025-01-24 07:55:00\",\"value\":3.95},{\"time\":\"2025-01-24 08:00:00\",\"value\":4.32},{\"time\":\"2025-01-24 08:05:00\",\"value\":4.74},{\"time\":\"2025-01-24 08:10:00\",\"value\":5.32},{\"time\":\"2025-01-24 08:15:00\",\"value\":6.02},{\"time\":\"2025-01-24 08:20:00\",\"value\":6.79},{\"time\":\"2025-01-24 08:25:00\",\"value\":7.71},{\"time\":\"2025-01-24 08:30:00\",\"value\":8.72},{\"time\":\"2025-01-24 08:35:00\",\"value\":9.74},{\"time\":\"2025-01-24 08:40:00\",\"value\":10.84},{\"time\":\"2025-01-24 08:45:00\",\"value\":12.19},{\"time\":\"2025-01-24 08:50:00\",\"value\":13.59},{\"time\":\"2025-01-24 08:55:00\",\"value\":15.07},{\"time\":\"2025-01-24 09:00:00\",\"value\":16.57},{\"time\":\"2025-01-24 09:05:00\",\"value\":17.94},{\"time\":\"2025-01-24 09:10:00\",\"value\":19.3},{\"time\":\"2025-01-24 09:15:00\",\"value\":20.72},{\"time\":\"2025-01-24 09:20:00\",\"value\":21.71},{\"time\":\"2025-01-24 09:25:00\",\"value\":22.62},{\"time\":\"2025-01-24 09:30:00\",\"value\":23.96},{\"time\":\"2025-01-24 09:35:00\",\"value\":25.25},{\"time\":\"2025-01-24 09:40:00\",\"value\":26.8},{\"time\":\"2025-01-24 09:45:00\",\"value\":28.29},{\"time\":\"2025-01-24 09:50:00\",\"value\":29.83},{\"time\":\"2025-01-24 09:55:00\",\"value\":31.22},{\"time\":\"2025-01-24 10:00:00\",\"value\":32.52},{\"time\":\"2025-01-24 10:05:00\",\"value\":34.06},{\"time\":\"2025-01-24 10:10:00\",\"value\":35.37},{\"time\":\"2025-01-24 10:15:00\",\"value\":36.69},{\"time\":\"2025-01-24 10:20:00\",\"value\":38.18},{\"time\":\"2025-01-24 10:25:00\",\"value\":39.78},{\"time\":\"2025-01-24 10:30:00\",\"value\":41.27},{\"time\":\"2025-01-24 10:35:00\",\"value\":42.62},{\"time\":\"2025-01-24 10:40:00\",\"value\":43.86},{\"time\":\"2025-01-24 10:45:00\",\"value\":45.0},{\"time\":\"2025-01-24 10:50:00\",\"value\":46.28},{\"time\":\"2025-01-24 10:55:00\",\"value\":47.59},{\"time\":\"2025-01-24 11:00:00\",\"value\":49.02},{\"time\":\"2025-01-24 11:05:00\",\"value\":50.37},{\"time\":\"2025-01-24 11:10:00\",\"value\":51.88},{\"time\":\"2025-01-24 11:15:00\",\"value\":53.89},{\"time\":\"2025-01-24 11:20:00\",\"value\":55.99},{\"time\":\"2025-01-24 11:25:00\",\"value\":58.3},{\"time\":\"2025-01-24 11:30:00\",\"value\":60.81},{\"time\":\"2025-01-24 11:35:00\",\"value\":63.94},{\"time\":\"2025-01-24 11:40:00\",\"value\":67.67},{\"time\":\"2025-01-24 11:45:00\",\"value\":72.55},{\"time\":\"2025-01-24 11:50:00\",\"value\":77.85},{\"time\":\"2025-01-24 11:55:00\",\"value\":81.55},{\"time\":\"2025-01-24 12:00:00\",\"value\":85.56},{\"time\":\"2025-01-24 12:05:00\",\"value\":89.09},{\"time\":\"2025-01-24 12:10:00\",\"value\":93.04},{\"time\":\"2025-01-24 12:15:00\",\"value\":96.21},{\"time\":\"2025-01-24 12:20:00\",\"value\":99.08},{\"time\":\"2025-01-24 12:25:00\",\"value\":101.44},{\"time\":\"2025-01-24 12:30:00\",\"value\":103.37},{\"time\":\"2025-01-24 12:35:00\",\"value\":105.01},{\"time\":\"2025-01-24 12:40:00\",\"value\":106.84},{\"time\":\"2025-01-24 12:45:00\",\"value\":108.84},{\"time\":\"2025-01-24 12:50:00\",\"value\":110.76},{\"time\":\"2025-01-24 12:55:00\",\"value\":112.56},{\"time\":\"2025-01-24 13:00:00\",\"value\":114.15},{\"time\":\"2025-01-24 13:05:00\"},{\"time\":\"2025-01-24 13:10:00\"},{\"time\":\"2025-01-24 13:15:00\"},{\"time\":\"2025-01-24 13:20:00\"},{\"time\":\"2025-01-24 13:25:00\"},{\"time\":\"2025-01-24 13:30:00\"},{\"time\":\"2025-01-24 13:35:00\"},{\"time\":\"2025-01-24 13:40:00\"},{\"time\":\"2025-01-24 13:45:00\"},{\"time\":\"2025-01-24 13:50:00\"},{\"time\":\"2025-01-24 13:55:00\"},{\"time\":\"2025-01-24 14:00:00\"},{\"time\":\"2025-01-24 14:05:00\"},{\"time\":\"2025-01-24 14:10:00\"},{\"time\":\"2025-01-24 14:15:00\"},{\"time\":\"2025-01-24 14:20:00\"},{\"time\":\"2025-01-24 14:25:00\"},{\"time\":\"2025-01-24 14:30:00\"},{\"time\":\"2025-01-24 14:35:00\"},{\"time\":\"2025-01-24 14:40:00\"},{\"time\":\"2025-01-24 14:45:00\"},{\"time\":\"2025-01-24 14:50:00\"},{\"time\":\"2025-01-24 14:55:00\"},{\"time\":\"2025-01-24 15:00:00\"},{\"time\":\"2025-01-24 15:05:00\"},{\"time\":\"2025-01-24 15:10:00\"},{\"time\":\"2025-01-24 15:15:00\"},{\"time\":\"2025-01-24 15:20:00\"},{\"time\":\"2025-01-24 15:25:00\"},{\"time\":\"2025-01-24 15:30:00\"},{\"time\":\"2025-01-24 15:35:00\"},{\"time\":\"2025-01-24 15:40:00\"},{\"time\":\"2025-01-24 15:45:00\"},{\"time\":\"2025-01-24 15:50:00\"},{\"time\":\"2025-01-24 15:55:00\"},{\"time\":\"2025-01-24 16:00:00\"},{\"time\":\"2025-01-24 16:05:00\"},{\"time\":\"2025-01-24 16:10:00\"},{\"time\":\"2025-01-24 16:15:00\"},{\"time\":\"2025-01-24 16:20:00\"},{\"time\":\"2025-01-24 16:25:00\"},{\"time\":\"2025-01-24 16:30:00\"},{\"time\":\"2025-01-24 16:35:00\"},{\"time\":\"2025-01-24 16:40:00\"},{\"time\":\"2025-01-24 16:45:00\"},{\"time\":\"2025-01-24 16:50:00\"},{\"time\":\"2025-01-24 16:55:00\"},{\"time\":\"2025-01-24 17:00:00\"},{\"time\":\"2025-01-24 17:05:00\"},{\"time\":\"2025-01-24 17:10:00\"},{\"time\":\"2025-01-24 17:15:00\"},{\"time\":\"2025-01-24 17:20:00\"},{\"time\":\"2025-01-24 17:25:00\"},{\"time\":\"2025-01-24 17:30:00\"},{\"time\":\"2025-01-24 17:35:00\"},{\"time\":\"2025-01-24 17:40:00\"},{\"time\":\"2025-01-24 17:45:00\"},{\"time\":\"2025-01-24 17:50:00\"},{\"time\":\"2025-01-24 17:55:00\"},{\"time\":\"2025-01-24 18:00:00\"},{\"time\":\"2025-01-24 18:05:00\"},{\"time\":\"2025-01-24 18:10:00\"},{\"time\":\"2025-01-24 18:15:00\"},{\"time\":\"2025-01-24 18:20:00\"},{\"time\":\"2025-01-24 18:25:00\"},{\"time\":\"2025-01-24 18:30:00\"},{\"time\":\"2025-01-24 18:35:00\"},{\"time\":\"2025-01-24 18:40:00\"},{\"time\":\"2025-01-24 18:45:00\"},{\"time\":\"2025-01-24 18:50:00\"},{\"time\":\"2025-01-24 18:55:00\"},{\"time\":\"2025-01-24 19:00:00\"},{\"time\":\"2025-01-24 19:05:00\"},{\"time\":\"2025-01-24 19:10:00\"},{\"time\":\"2025-01-24 19:15:00\"},{\"time\":\"2025-01-24 19:20:00\"},{\"time\":\"2025-01-24 19:25:00\"},{\"time\":\"2025-01-24 19:30:00\"},{\"time\":\"2025-01-24 19:35:00\"},{\"time\":\"2025-01-24 19:40:00\"},{\"time\":\"2025-01-24 19:45:00\"},{\"time\":\"2025-01-24 19:50:00\"},{\"time\":\"2025-01-24 19:55:00\"},{\"time\":\"2025-01-24 20:00:00\"},{\"time\":\"2025-01-24 20:05:00\"},{\"time\":\"2025-01-24 20:10:00\"},{\"time\":\"2025-01-24 20:15:00\"},{\"time\":\"2025-01-24 20:20:00\"},{\"time\":\"2025-01-24 20:25:00\"},{\"time\":\"2025-01-24 20:30:00\"},{\"time\":\"2025-01-24 20:35:00\"},{\"time\":\"2025-01-24 20:40:00\"},{\"time\":\"2025-01-24 20:45:00\"},{\"time\":\"2025-01-24 20:50:00\"},{\"time\":\"2025-01-24 20:55:00\"},{\"time\":\"2025-01-24 21:00:00\"},{\"time\":\"2025-01-24 21:05:00\"},{\"time\":\"2025-01-24 21:10:00\"},{\"time\":\"2025-01-24 21:15:00\"},{\"time\":\"2025-01-24 21:20:00\"},{\"time\":\"2025-01-24 21:25:00\"},{\"time\":\"2025-01-24 21:30:00\"},{\"time\":\"2025-01-24 21:35:00\"},{\"time\":\"2025-01-24 21:40:00\"},{\"time\":\"2025-01-24 21:45:00\"},{\"time\":\"2025-01-24 21:50:00\"},{\"time\":\"2025-01-24 21:55:00\"},{\"time\":\"2025-01-24 22:00:00\"},{\"time\":\"2025-01-24 22:05:00\"},{\"time\":\"2025-01-24 22:10:00\"},{\"time\":\"2025-01-24 22:15:00\"},{\"time\":\"2025-01-24 22:20:00\"},{\"time\":\"2025-01-24 22:25:00\"},{\"time\":\"2025-01-24 22:30:00\"},{\"time\":\"2025-01-24 22:35:00\"},{\"time\":\"2025-01-24 22:40:00\"},{\"time\":\"2025-01-24 22:45:00\"},{\"time\":\"2025-01-24 22:50:00\"},{\"time\":\"2025-01-24 22:55:00\"},{\"time\":\"2025-01-24 23:00:00\"},{\"time\":\"2025-01-24 23:05:00\"},{\"time\":\"2025-01-24 23:10:00\"},{\"time\":\"2025-01-24 23:15:00\"},{\"time\":\"2025-01-24 23:20:00\"},{\"time\":\"2025-01-24 23:25:00\"},{\"time\":\"2025-01-24 23:30:00\"},{\"time\":\"2025-01-24 23:35:00\"},{\"time\":\"2025-01-24 23:40:00\"},{\"time\":\"2025-01-24 23:45:00\"},{\"time\":\"2025-01-24 23:50:00\"},{\"time\":\"2025-01-24 23:55:00\"}]",
"inverterSN": "56118"
},
"timestamp": 1737695250805
}
系统可用性配置
接口描述
通过指定监控电站 ID，获取电站系统可用性的最小值和最大值。
请求方法
/sol_monitor/plant/getRangeByPlantId
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | query | Long | 否 | 监控电站 id |
| X-Access-Token | header | string | 是 | token |
枚举值
无
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果的提示消息 | ||
| » code | integer | true | 请求状态码 | ||
| » result | List | true | 系统可用性的最大值和最小值 | ||
| »»» min | Double | true | 系统可用性最小值 | ||
| »»» max | Double | true | 系统可用性最大值 | ||
| » timestamp | String | true | 响应数据的时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"min": null,
"max": null
},
"timestamp": 1737701381011
}
系统可用性
接口描述
通过电站 ID、日期、图表数据类型获取电站的系统可用性的数据。
请求方法
/sol_monitor/plant/usabilityChart
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | query | Long | 否 | 监控电站 id，用于唯一标识一个电站 |
| datetime | query | String | 是 | 日期，格式为年-月-日，例如 20250124 |
| dataType | query | String | 是 | 图表数据类型，决定数据的聚合时间范围 |
| X-Access-Token | header | string | 是 | token |
枚举值
| 属性 | 值 | 说明 |
|---|---|---|
| dataType | MONTH | 月，根据传入时间获取这一个月的数据 |
| dataType | YEAR | 年，根据传入时间获取该年每个月的数据 |
| dataType | TILL_NOW | 总，每年的数据 |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | 请求是否成功 | ||
| » message | string | true | 请求结果提示信息 | ||
| » code | integer | true | 状态码 | ||
| » result | List | true | 系统可用性的具体数据 | ||
| »» time | string | true | 聚合粒度具体时间 | 月：日，年：月，总：年 | |
| »» value | Double¦ string | true | 系统可用性的值 | ||
| »» apiValue | Double¦ string | true | 接口来源的值 | ||
| »» year | Integer¦ string | true | 年 | ||
| »» month | Integer¦ string | true | 月 | ||
| »» day | Integer¦ string | true | 天 | ||
| »» allDate | String¦ String | true | 日期 | ||
| »» isnull | Integer | true | 是否是填补的数据 | ||
| »» equivalentGenerationHours | Double | true | 等效发电小时数 | ||
| » timestamp | String | true | 响应时间戳 |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": [
{
"time": "1",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "2",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "3",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "4",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "5",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "6",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "7",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "8",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "9",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "10",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "11",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "12",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "13",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "14",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "15",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "16",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "17",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "18",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "19",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "20",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "21",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "22",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "23",
"value": 1.0,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "24",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "25",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "26",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "27",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "28",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "29",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "30",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
},
{
"time": "31",
"value": null,
"apiValue": null,
"year": null,
"month": null,
"day": null,
"allDate": null,
"isnull": null,
"equivalentGenerationHours": null
}
],
"timestamp": 1737702486659
}
设备告警列表
接口描述
设备告警列表
请求方法
/sol_monitor/alarm/list
请求方式
GET
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| alarmStatus | query | string | 否 | 告警状态:1.告警中 2.结束 |
| alarmLevel | query | string | 否 | 告警等级:1.预警 2.故障 3.健康 |
| deviceSn | query | string | 是 | 设备SN |
| source | query | string | 否 | 来源 0: app 1:pc |
| param | query | string | 是 | 关键字 设备名或者sn |
| deviceId | query | number | 是 | 设备Id |
| deviceType | query | integer | 是 | 设备类型 0：逆变器 1：电表 2：采集器 3：辐照仪 5：组串 6：虚拟辐照仪 7：汇流箱 9：SIM卡 |
| plantId | query | number | 否 | 电站Id |
| begin | query | string | 否 | 开始时间 |
| end | query | string | 否 | 结束时间 |
| dataType | query | string | 否 | 日期类型 |
| X-Access-Token | header | string | 是 |
枚举值
| 属性 | 值 |
|---|---|
| dataType | DAY |
| dataType | DAY_BEFORE_MONTH |
| dataType | SEVEN_DAY |
| dataType | MONTH |
| dataType | YEAR |
| dataType | TOTAL |
| dataType | TILL_NOW |
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | |||
| » message | string | true | |||
| » code | integer | true | |||
| » result | object | true | |||
| »» content | [object] | true | |||
| »»» id | integer | true | |||
| »»» createTime | string | true | 创建时间 | ||
| »»» updateTime | string | true | 更新时间 | ||
| »»» alarmNumber | null | true | 告警编码 | ||
| »»» deviceSn | string | true | 设备SN | ||
| »»» deviceId | string | true | 设备ID | ||
| »»» deviceName | string | true | 设备别名 | ||
| »»» plantId | string | true | 电站ID | ||
| »»» alarmLevel | integer | true | 告警等级 | ||
| »»» alarmStatus | integer | true | 告警状态 | ||
| »»» alarmDes | string | true | 告警描述 | ||
| »»» alarmTime | string | true | 告警时间 | ||
| »»» alarmEndTime | string | true | 告警结束时间 | ||
| »»» plantName | string | true | 电站名称 | ||
| »»» deviceType | integer | true | 设备类型:0.逆变器 1.电表 2.采集器 | ||
| »»» errorCode | string | true | 错误码 | ||
| »»» duration | integer | true | 持续时间 | ||
| »»» alarmKey | null | true | 告警key | ||
| »»» time | integer | true | 持续时间 | ||
| »»» troubleshootingMethod | string | true | 排查方法 | ||
| »» pageable | object | true | |||
| »»» sort | object | true | |||
| »»»» sorted | boolean | true | |||
| »»»» unsorted | boolean | true | |||
| »»»» empty | boolean | true | |||
| »»» pageSize | integer | true | |||
| »»» pageNumber | integer | true | |||
| »»» offset | integer | true | |||
| »»» unpaged | boolean | true | |||
| »»» paged | boolean | true | |||
| »» totalElements | integer | true | |||
| »» totalPages | integer | true | |||
| »» last | boolean | true | |||
| »» first | boolean | true | |||
| »» sort | object | true | |||
| »»» sorted | boolean | true | |||
| »»» unsorted | boolean | true | |||
| »»» empty | boolean | true | |||
| »» numberOfElements | integer | true | |||
| »» size | integer | true | |||
| »» number | integer | true | |||
| »» empty | boolean | true | |||
| » timestamp | integer | true |
返回示例
{
"success": true,
"message": "操作成功！",
"code": 200,
"result": {
"content": [
{
"id": 101173,
"createTime": "2025-01-05 13:36:21",
"updateTime": "2025-01-05 13:46:30",
"alarmNumber": null,
"deviceSn": "8060KMTS188G0016",
"deviceId": "56515",
"deviceName": "P1-R1-NB01",
"plantId": "43374",
"alarmLevel": 2,
"alarmStatus": 2,
"alarmDes": "固德威故障码9:电网丢失故障",
"alarmTime": "2025-01-05 13:33:53",
"alarmEndTime": "2025-01-05 13:46:30",
"plantName": "东阳富仕特磁业",
"deviceType": 0,
"errorCode": "E9",
"duration": 12,
"alarmKey": null,
"time": 12,
"troubleshootingMethod": "故障原因：1.电网停电2.机器AC端接线异常3.AC开关连接异常或开关损坏4.AC端未连接。解决方案：1.确定电网是否停电2.利用万用表测量机器AC端是否有电压3.检查AC开关是否损坏4.确认AC端接线是否有误（零火线是否接反）5.确认电网连接正常，确保AC开关闭合6.尝试关闭机器DC/AC端，5分钟之后重新连接DC/AC端"
}
],
"pageable": {
"sort": {
"sorted": true,
"unsorted": false,
"empty": false
},
"pageSize": 10,
"pageNumber": 0,
"offset": 0,
"unpaged": false,
"paged": true
},
"totalElements": 1,
"totalPages": 1,
"last": true,
"first": true,
"sort": {
"sorted": true,
"unsorted": false,
"empty": false
},
"numberOfElements": 9,
"size": 10,
"number": 0,
"empty": false
},
"timestamp": 1737706657242
}