# 首页 ## API接口一览表 | 接口分类 | 接口描述 | 查询条件 | API接口 | 权限 | |--------|-------------|------------------------------| ---------------------------- | ---------------------------- | | 2.1 首页 | 2.1.1风场概况 | 实时数据，没有入参 | /api/home/windFarmOverview | | | | 2.1.2今日运行状态 | 实时数据，没有入参 | /api/home/currentDayStatus | | | | 2.1.3功率趋势 | 当天24小时数据，5分钟间隔 | /api/home/powerTrends | | | | 2.1.4风机矩阵 | 实时数据，没有参数 | /api/home/windTurbineMatrix | | | | 2.1.5发电量概况 | 昨日数据； | /api/home/generationOverview | | | | 2.1.6发电量趋势 | 日： 当前月的每日数据；同期是去年数据；月：当年每月月数据，12个月； | /api/home/generationTrend | | | | 2.1.7实时告警 | 近一个月内所有的报警数据，滚动显示；已确认的数据 按钮灰色；未确认的显示确认按钮 | /api/home/realTimeAlert | | | | 2.1.8实时告警确认 | 告警记录ID | /api/home/realTimeAlertConfirm | | ## 2.1 首页相关接口 ### 2.1.1 风场概况 POST 请求接口 > /api/home/windFarmOverview 请求参数 无 注:实时数据,没有入参 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": { "power": 56.2, "windSpeed": 45.3, "dailyUsageHours": 20, "monthlyUsageHours": 78 } } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | | ------------- |---------| ---- |--------| | power | Double | 否 | 功率 | | windSpeed | Double | 否 | 风速 | | dailyUsageHours | Integer | 否 | 日利用小时数 | | monthlyUsageHours | Integer | 否 | 月利用小时数 | ### 2.1.2 今日运行状态 POST 请求接口 > /api/home/currentDayStatus 请求参数 无 注:实时数据,没有入参 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": { "windTurbineNum": 40, "installedCapacity": 45.32, "runCapacity": 20.2, "runNum": 78, "standbyCapacity": 63.2, "standbyNum": 35, "faultCapacity": 56.4, "faultNum": 53, "offlineCapacity": 16.4, "offlineNum": 20 } } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | | ------------- |---------| ---- |------| | windTurbineNum | Integer | 否 | 风机台数 | | installedCapacity | Double | 否 | 装机容量 | | runCapacity | Double | 否 | 运行容量 | | runNum | Integer | 否 | 运行台数 | | standbyCapacity | Double | 否 | 待机容量 | | standbyNum | Integer | 否 | 待机台数 | | faultCapacity | Double | 否 | 故障容量 | | faultNum | Integer | 否 | 故障台数 | | offlineCapacity | Double | 否 | 离线容量 | | offlineNum | Integer | 否 | 离线台数 | ### 2.1.3 功率趋势 POST 请求接口 > /api/home/powerTrends 请求参数 无 注:当天24小时数据，5分钟间隔 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": [ { "power": 12.6, "windSpeed": 56.3, "dataTime": "2024-10-17 00:00:00" }, { "power": 10.6, "windSpeed": 16.3, "dataTime": "2024-10-17 00:05:00" } ] } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | |-------------|--------| ---- |------| | power | Double | 否 | 功率 | | windSpeed | Double | 否 | 风速 | | dataTime | String | 否 | 数据时间 | ### 2.1.4 风机矩阵 POST 请求接口 > /api/home/windTurbineMatrix 请求参数 无 注:实时数据 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": [ { "power": 12.6, "windSpeed": 56.3, "dayGeneration": 56.2, "windStatus": "并网", "standard": 1, "windTurbine": "GDWT00001" }, { "power": 12.6, "windSpeed": 56.3, "dayGeneration": 56.2, "windStatus": "待机", "standard": 1, "windTurbine": "GDWT00002" } ] } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | |-------------|---------| ---- |---------| | power | Double | 否 | 功率 | | windSpeed | Double | 否 | 风速 | | dayGeneration | Double | 否 | 日发电量 | | windStatus | String | 否 | 风机状态 | | standard | Integer | 否 | 是否为标杆机组 | | windTurbine | String | 否 | 风机编码 | ### 2.1.5 发电量概况 POST 请求接口 > /api/home/generationOverview 请求参数 ```json { "requestTime":"2024-10-16" } ``` 入参描述 | 参数名 | 参数类型 | 可选 | 描述 | | ------------ | -------- | ---- |------| | requestTime | String | yes | 请求时间 | 注:请求时间默认为:昨日时间 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": { "dailyGeneration": 63.2, "dayGeneration": 56.2, "monthGeneration": 60.2, "yearGeneration": 200.6, "totalGeneration": 500.6 } } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | |-------------|---------| ---- |-------| | dailyGeneration | Double | 否 | 当日发电量 | | dayGeneration | Double | 否 | 日发电量 | | monthGeneration | Double | 否 | 月发电量 | | yearGeneration | Double | 否 | 年发电量 | | totalGeneration | Double | 否 | 总发电量 | ### 2.1.6 发电量趋势 POST 请求接口 > /api/home/generationTrend 请求参数 ```json { "timeType":"日" } ``` 注: 日:当前月的每日数据；同期是去年数据；月:当年每月月数据，12个月； 入参描述 | 参数名 | 参数类型 | 可选 | 描述 | | ------------ | -------- | ---- |------| | timeType | String | yes | 时间类型 | 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": [ { "currentPeriod": 56.3, "samePeriod": 63.5, "generationTime": "2024-10-01" }, { "currentPeriod": 66.3, "samePeriod": 73.5, "generationTime": "2024-10-02" } ] } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | |-------------|---------| ---- |-------| | currentPeriod | Double | 否 | 本期 | | samePeriod | Double | 否 | 同期 | | generationTime | Double | 否 | 发电量时间 | ### 2.1.7 实时告警 POST 请求接口 > /api/home/realTimeAlert 请求参数 无 注:近一个月内所有的报警数据，滚动显示；已确认的数据 按钮灰色；未确认的显示确认按钮 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": [ { "alertTime": "2024-10-16 12:16:42", "windTurbine": "SC-01", "alertContent": "故障", "alertId": 4562366, "confirmStatus": 0 }, { "alertTime": "2024-10-16 12:16:42", "windTurbine": "SC-01", "alertContent": "待机", "alertId": 4562366555, "confirmStatus": 1 } ] } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | |-------------|---------| ---- |------| | alertTime | String | 否 | 告警时间 | | windTurbine | String | 否 | 风机编码 | | alertContent | String | 否 | 告警内容 | | alertId | Long | 否 | 告警id | | confirmStatus | Integer | 否 | 确认状态 | ### 2.1.8 实时告警-确认 POST 请求接口 > /api/home/realTimeAlertConfirm 请求参数 ```json { "alertId":45566222 } ``` 入参描述 | 参数名 | 参数类型 | 可选 | 描述 | | ------------ |------| ---- |------| | alertId | Long | yes | 告警id | 返回报文 ```json { "code": 200, "msg": "操作成功", "success": true, "data": [ ] } ``` 返参描述 | 参数名 | 参数类型 | 可选 | 描述 | |-------------|---------| ---- |-------|