map/docs/api/pages/home.md

首页

API接口一览表

接口分类	接口描述	查询条件	API接口	权限
2.1 首页	2.1.1风机矩阵	实时数据，没有入参	/api/home/getWindTurbineMatrixData
	2.1.2获取风电场实时数据	风电场id	/api/home/getWindFarmRealData

2.1 首页相关接口

2.1.1 风机矩阵

POST 请求接口

/api/home/getWindTurbineMatrixData

请求参数

无

注:实时数据,没有入参

返回报文

{
  "code": 200,
  "success": true,
  "data": [
    {
      "irn": "1846101273013739522",
      "name": "A-001",
      "modelId": "1807685851882508289",
      "model": "倍福1.5",
      "belongLine": "线路1",
      "standard": 1,
      "nominalCapacity": 66.23,
      "attributeMap": {
        "iwindspeed": 10.84000015258789,
        "iturbineoperationmode": 6,
        "iyplevel": 0,
        "ikwhthisday": 0,
        "igenpower": 0,
        "gridlostdetected": 0
      }
    }
  ],
  "msg": "操作成功"
}

返参描述

参数名	参数类型	可选	描述
standard	Integer	否	是否标杆
nominalCapacity	Double	否	容量
iwindspeed	Double	否	风速
iyplevel	Double	否	偏航运行模式
ikwhthisday	Double	否	日发电量
igenpower	Double	否	有功功率
gridlostdetected	Double	否	风机电网掉电

2.1.2 获取风电场实时数据

POST 请求接口

/api/home/getWindFarmRealData

请求参数

{
    "windFarmId":1846101273013739522  
}

入参描述

参数名	参数类型	可选	描述
windFarmId	Long	yes	风场id

返回报文

{
  "code": 200,
  "success": true,
  "data": {
    "windFarmId": 1848624295633317890,
    "attributeMap": {
      "windfarmactivepower": 111.01,
      "windfarmavgwindspeed": 111.01,
      "windfarmdayoperationhours": 111.01,
      "windfarmmonthoperationhours": 111.01,
      "windfarmdayprodenergy": 111.01,
      "windfarmmonthprodenergy": 111.01,
      "windfarmyearprodenergy": 111.01,
      "windfarmtotalprodenergy": 111.01
    }
  },
  "msg": "操作成功"
}

返参描述

参数名	参数类型	可选	描述
windFarmId	Long	否	风场id
windfarmactivepower	Double	否	功率
windfarmavgwindspeed	Double	否	平均风速
windfarmdayoperationhours	Double	否	日利用小时
windfarmmonthoperationhours	Double	否	月利用小时
windfarmdayprodenergy	Double	否	日发电量
windfarmmonthprodenergy	Double	否	月发电量
windfarmyearprodenergy	Double	否	年发电量
windfarmtotalprodenergy	Double	否	总发电量

2.1.3 获取风电场历史数据

POST 请求接口

/api/home/getHistoryData

请求参数

{
  "startTime": "123452435324242",
  "endTime": "123452435924242",
  "devices": [
    {
      "deviceId":"129476828342323",
      "attributes":["power","windSpeed"]
    },
    {
      "deviceId":"129476828342324",
      "attributes":["power","dailyUsageHours"]
    }
  ],
  "interval": "5m"
}

入参描述

参数名	参数类型	可选	描述
startTime	String	no	开始时间戳
endTime	String	no	结束时间戳
devices.deviceId	String	no	设备ID
devices.attributes	StringArray	no	要查询实时数据的设备属性列表
interval	String	yes	抽样间隔,1a(毫秒),1s(秒),1m(分),1h(小时),1d(天),1w(周)。 忽略或者值为空时，返回原始数据（不抽样）
endTime	String	no	结束时间戳
返回报文

{
  "code": 200,
  "msg": "操作成功",
  "success": true,
  "data": {
    //设备ID
    "129476828342323":{
      //属性名
      "power": {
        //时间戳列表
        "times": [123452435924242,123452435924342,123452435924442,123452435924542],
        //值列表
        "values": [123.23,35.21,34.56,67]
      } ,
      //属性名
      "windSpeed": {
        "times": [123452435924242,123452435924342,123452435924442,123452435924542],
        "values": [123.23,35.21,34.56,67]
      }
    },
    .......
  }
}