查询电站下的设备列表

接口描述

功能描述

根据电站ID查询电站下的设备列表。

访问限制

每个ip的限流次数：每分钟10次。

请求方式

HTTPS调用

POST https://we.goodwe.com/api/openapi/v1/service/getStationDeviceList

Header参数

属性	类型	必填	说明
Authorization	String	是	用户token

请求参数

属性	类型	必填	说明
stationId	String	是	电站id
isGetFirmwareVersion	String	否	是否需要获取设备的固件版本信息（1：需要 0：不需要默认不需要）
deviceTypes	List<String>	否	设备类型设备类型（Inverter逆变器、ElectricMeter电能表、DataCollector数采远红外、EnvironmentalTester环境检测仪、TemperatureSensor温度传感器、BMS电池系统、Store_PCS储能PCS、Store_BMS电池簇、Store_Pack电池包、Battery_Stack电池堆、EleStoringEquipment储能一体柜、LiquidCooler液冷机、AntiFire消防）(不传默认查全部设备类型) ）

返回参数

属性	类型	说明	示例值
code	String	请求成功或失败标识，“00000”请求成功，其余code请求失败	-
description	String	请求结果描述	-
data	Object	返回数据	-
data.tenantId	Long	租户id	1436240154054823938
data.id	Long	设备id	1746805684973993984
data.name	String	设备名称	环测-1组
data.sn	String	设备sn	08a0303a979b
data.templateCode	String	设备类型	ElectricMeter
data.state	String	设备状态code	1000-运行,1001-待机,1002-故障,1003-停机,1004-休眠,1005-离线,1011-异常
data.stateName	String	设备状态name	1000-运行,1001-待机,1002-故障,1003-停机,1004-休眠,1005-离线,1011-异常
data.nodeId	String	设备节点id	1746769399412555778
data.stationId	String	所属场站id	1742449261636855336
data.systemId	String	所属系统id	1789836820771635200
data.attributeValues	List<Object>	设备属性	-
data.attributeValues.attributeCode	String	属性编码	SIMCardNumber
data.attributeValues.attributeName	String	属性名称	SIM卡号
data.attributeValues.attributeValue	String	属性值	12345678

其他说明

调用示例

请求数据示例

json
{
  // 站点id
  "stationId": 1462592467743408128,
  // 是否需要获取设备的固件版本信息 1：需要 0：不需要 默认不需要
  "isGetFirmwareVersion": 1,
  // 设备类型（Inverter逆变器、ElectricMeter电能表、DataCollector数采远红外、EnvironmentalTester环境检测仪、TemperatureSensor温度传感器、BMS电池系统、Store_PCS储能PCS、Store_BMS电池簇、Store_Pack电池包、Battery_Stack电池堆、EleStoringEquipment储能一体柜、LiquidCooler液冷机、AntiFire消防）
  "deviceTypes": ["Inverter"]
}

返回数据示例

样例1：返回设备列表成功

json
{
  "code": "00000",
  "description": "成功",
  "data": [
    {
      "id": "1746805684973993984", //设备信息
      "name": "环测-1组",
      "templateCode": "Inverter",
      "templateType": "Device",
      "tenantId": "1436240154054823938",
      "nodeId": "1746769399412555778",
      "sn": "08a0303a979b",
      "state": "1000",
      "stateName": "运行",
      "stationId": "1798273970156470272",
      "systemId": "1698571590293389312",
      "attributeValues": [
        //设备固件信息
        {
          "attributeCode": "SIMCardNumber",
          "attributeName": "SIM卡号",
          "attributeValue": "89860481122180046910"
        },
        {
          "attributeCode": "SIMCardSuffix",
          "attributeName": "物联卡号后缀",
          "attributeValue": "1440817956510"
        },
        {
          "attributeCode": "RatedPower",
          "attributeName": "上行额定功率",
          "attributeValue": "8000"
        },
        {
          "attributeCode": "PackagDate",
          "attributeName": "出厂日期1",
          "attributeValue": "2021-10-20T08:39:07.499Z"
        },
        {
          "attributeCode": "RuningDate",
          "attributeName": "投运日期",
          "attributeValue": "2021-10-20T08:39:08.464Z"
        },
        {
          "attributeCode": "BracketModel",
          "attributeName": "支架型号",
          "attributeValue": "22"
        },
        {
          "attributeCode": "Flow",
          "attributeName": "流量",
          "attributeValue": "100MB",
          "attributeValueName": "100MB"
        },
        {
          "attributeCode": "Type",
          "attributeName": "类型",
          "attributeValue": "CentralizedInverter",
          "attributeValueName": "集中式逆变器"
        },
        {
          "attributeCode": "Group",
          "attributeName": "机型",
          "attributeValue": "Storage",
          "attributeValueName": "储能"
        }
      ],
      "extraInfoList": []
    },
    {
      "id": "1750696177474600960",
      "name": "箱变高压负荷开关",
      "tenantId": "1436240154054823938",
      "nodeId": "1750697742205845504",
      "templateCode": "Inverter",
      "templateType": "Device",
      "sn": "08a6663a739b",
      "state": "1005",
      "stateName": "离线",
      "stationId": "1798273970156470272",
      "systemId": "1698571590293389312"
    },
    {
      "id": "1750696530630803456",
      "name": "箱式变压器低压侧",
      "code": "08a6669a739b",
      "tenantId": "1436240154054823938",
      "nodeId": "1750697389565542400",
      "templateCode": "DataCollector",
      "templateType": "Device",
      "state": "1005",
      "stateName": "离线",
      "stationId": "1798273970156470272",
      "systemId": "1698571590293389312",
      "sn": "08a6669a739b"
    },
    {
      "id": "1749977505734983680",
      "name": "逆变器-4",
      "tenantId": "1436240154054823938",
      "nodeId": "1749977814880354304",
      "templateCode": "Inverter",
      "templateType": "Device",
      "state": "1005",
      "stateName": "离线",
      "stationId": "1798273970156470272",
      "systemId": "1698571590293389312",
      "sn": "08a7303a079b",
      "attributeValues": [
        {
          "attributeName": "类型",
          "attributeCode": "Type",
          "attributeValue": "SeriesInverter"
        }
      ]
    },
    {
      "id": "1782728181225226240",
      "name": "红外-数据曲线测试1",
      "tenantId": "1436240154054823938",
      "nodeId": "1746772485568856064",
      "state": "1000",
      "stateName": "运行",
      "templateCode": "DataCollector",
      "templateType": "Device",
      "stationId": "1798273970156470272",
      "systemId": "1698571590293389312",
      "sn": "08a9991a739b",
      "attributeValues": [
        {
          "attributeName": "创建mqtt认证信息状态",
          "attributeCode": "MqttAuth",
          "attributeValue": "Yes"
        },
        {
          "attributeName": "倍率",
          "attributeCode": "Coefficient",
          "attributeValue": "4"
        },
        {
          "attributeName": "翻转状态",
          "attributeCode": "IsFlip",
          "attributeValue": "No"
        }
      ]
    }
  ]
}

大纲

接口描述
- 功能描述
- 访问限制
请求方式
调用示例
- 请求数据示例
- 返回数据示例