汇流箱

---

title: 汇流箱

汇流箱接口文档

电站详情-设备-汇流箱

接口描述

通过关键字，电站ID，接入状态，查看电站下的汇流箱了列表

请求方法

/sol_monitor/combiner/list

请求方式

POST

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	否
» plantId	body	string	是	电站 id
» keyWord	body	string	是	关键字
» accessStatus	body	string	是	接入状态
» status	body	string	是	状态
» page	body	integer	是	页数
» pageSize	body	integer	是	页码

Body 请求参数示例

{
  "plantId": "43374",
  "keyWord": "",
  "accessStatus": "",
  "status": "",
  "page": 1,
  "pageSize": 20
}

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true
» message	string	true
» code	integer	true
» result	object	true
»» content	[object]	true
»»» irradiatorAlias	string	true		设备别名
»»» irradiatorSn	string	true		设备SN
»»» brand	string	true		设备品牌
»»» model	string	true		设备型号
»»» keepEndTime	string	true		质保到期时间
»»» electricVoltage	string	true		电压
»»» electricCurrent	string	true		电流
»»» combinerPower	string	true		功率
»»» unitDay	string	true		单位发电量
»»» eDay	string	true		发电量
»»» dataUpdateTime	string	true		数据更新时间
»» totalElements	integer	true
»» totalPages	integer	true
» timestamp	integer	true

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "content": [{
      "irradiatorAlias":"",
      "irradiatorSn":"",
      "brand":"",
      "model":"",
      "keepEndTime":"",
      "electricVoltage":"",
      "electricCurrent":"",
      "combinerPower":"",
      "unitDay":"",
      "eDay":"",
      "dataUpdateTime":"",
    }],
    "totalElements": 0,
    "totalPages": 0,
    "numberOfElements": 0
  },
  "timestamp": 1737688575086
}

设备管理-汇流箱

接口描述

通过关键字，电站ID，接入状态，查看用户下的汇流箱了列表

请求方法

/sol_monitor/combiner/user/list

请求方式

GET

请求参数

名称	位置	类型	必选	中文名	说明
keyWord	query	string	是		关键字
accessStatus	query	string	是		接入状态
status	query	string	是		状态
page	query	string	是		页数
pageSize	query	string	是		页码
serviceModule	header	string	是

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true
» message	string	true
» code	integer	true
» result	object	true
»» content	[object]	true
»»» irradiatorAlias	string	true		设备别名
»»» irradiatorSn	string	true		设备SN
»»» brand	string	true		设备品牌
»»» model	string	true		设备型号
»»» keepEndTime	string	true		质保到期时间
»»» electricVoltage	string	true		电压
»»» electricCurrent	string	true		电流
»»» combinerPower	string	true		功率
»»» unitDay	string	true		单位发电量
»»» eDay	string	true		发电量
»»» dataUpdateTime	string	true		数据更新时间
»» totalElements	integer	true
»» totalPages	integer	true
» timestamp	integer	true

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "content": [{
      "irradiatorAlias":"",
      "irradiatorSn":"",
      "brand":"",
      "model":"",
      "keepEndTime":"",
      "electricVoltage":"",
      "electricCurrent":"",
      "combinerPower":"",
      "unitDay":"",
      "eDay":"",
      "dataUpdateTime":"",
    }],
    "totalElements": 0,
    "totalPages": 0,
    "numberOfElements": 0
  },
  "timestamp": 1737688575086
}

接口描述

根据 id 获取汇流箱详情信息。

请求方式

GET

请求方法

/sol_monitor/combiner/detail/432

请求参数

名称	位置	类型	必选	说明
id	query	string	是	汇流箱 ID

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "id": 432,
    "createTime": "2025-02-28 11:24:18",
    "updateTime": "2025-03-18 16:23:38",
    "dataAccessTime": "2025-02-24 18:31:24",
    "plantId": 43690,
    "combinerAlias": "202110160005_20",
    "combinerSn": "202110160005_20",
    "combinerCommunicationAddr": "20",
    "collectorId": 11049,
    "combinerCollector": "202110160005",
    "accessStatus": 1,
    "communicationStatus": 1,
    "associatedDeviceMode": 0,
    "combinerCollectorName": "202110160005",
    "scopeUseId": null,
    "scopeUseName": null,
    "apiId": null,
    "apiName": null,
    "branchCapacity": 10070,
    "combinerCapacity": 10070,
    "modelName": "通用",
    "modelId": 1364,
    "brandName": "优得",
    "brandId": 1830,
    "unitDay": 182.89,
    "electricCurrent": 0,
    "electricVoltage": 56,
    "combinerPower": 0,
    "dataUpdateTime": "2025-03-07 19:01:55",
    "dataPresentationSource": "1",
    "arrayCount": null,
    "totalEnergy": null,
    "keepYears": null,
    "keepStartTime": null,
    "keepEndTime": null,
    "nameRule": 1,
    "forwardPhotos": null,
    "forwardPhotosUploadStatus": null,
    "assetsViewStatus": null,
    "areaDivideId": null,
    "areaDivideName": null,
    "keepMonths": null,
    "keepDaily": null,
    "deviceImage": "http://zone-monitor-uat.oss-cn-shanghai.aliyuncs.com/temp/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20240411101110_1739253053418.png?Expires=1742379478&OSSAccessKeyId=LTAI5tS2FtqMmVADKmbjjux9&Signature=IIm7u4m%2BXxX2V2DufZNBgx6rPn8%3D&x-oss-process=image%2Fresize%2Cm_lfit%2Ch_400%2Cw_400",
    "eDay": 101.48
  },
  "timestamp": 1742375878767
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	object	true	none		none
»» id	integer	true	none	汇流箱 ID	none
»» createTime	string	true	none	开始时间	none
»» updateTime	string	true	none	数据更新时间	none
»» dataAccessTime	string	true	none	数据访问时间	none
»» plantId	integer	true	none	电站 ID	none
»» combinerAlias	string	true	none	设备名称	none
»» combinerSn	string	true	none	设备 SN	none
»» combinerCommunicationAddr	string	true	none	通讯地址	none
»» collectorId	integer	true	none	采集器 ID	none
»» combinerCollector	string	true	none	关联采集器	none
»» accessStatus	integer	true	none	接入状态	none
»» communicationStatus	integer	true	none	通讯状态	none
»» associatedDeviceMode	integer	true	none	关联设备方式	0：通过采集器关联，1：通过接口关联
»» combinerCollectorName	string	true	none	采集器名称	none
»» scopeUseId	null	false	none		none
»» scopeUseName	null	false	none		none
»» apiId	null	false	none	数据接入 id	none
»» apiName	null	false	none	数据接入描述	none
»» branchCapacity	integer	true	none	支路容量	none
»» combinerCapacity	integer	true	none	装机容量	none
»» modelName	string	true	none	设备型号	none
»» modelId	integer	true	none	型号 ID	none
»» brandName	string	true	none	设备品牌	none
»» brandId	integer	true	none	品牌 ID	none
»» unitDay	number	true	none	单位发电量	none
»» electricCurrent	integer	true	none	电流	none
»» electricVoltage	integer	true	none	电压	none
»» combinerPower	integer	true	none	功率	none
»» dataUpdateTime	string	true	none	数据更新时间	none
»» dataPresentationSource	string	true	none	数据来源	none
»» arrayCount	null	false	none	组串数量	none
»» totalEnergy	null	false	none	总发电量	none
»» keepYears	null	false	none	质保时长(年)	none
»» keepStartTime	null	false	none	质保开始时间	none
»» keepEndTime	null	false	none	质保结束时间	none
»» nameRule	integer	true	none	规则名称	none
»» forwardPhotos	null	false	none	转发照片	none
»» forwardPhotosUploadStatus	null	false	none	转发照片上传状态	none
»» assetsViewStatus	null	false	none	资产视图状态	none
»» areaDivideId	null	false	none	区域划分 ID	none
»» areaDivideName	null	false	none	区域划分名称	none
»» keepMonths	null	false	none	质保时长(月)	none
»» keepDaily	null	false	none	质保时长(天)	none
»» deviceImage	string	true	none	设备图片	none
»» eDay	number	true	none	日发电量	none
» timestamp	integer	true	none		none

汇流箱设备图表

接口描述

根据 汇流箱 ID ,时间,keyList 获取汇流箱设备图表数据

请求方式

POST

请求方法

/sol_monitor/iot/combinerBox

属性	值	说明
keyList	E_DAY_ARR	日发电量
keyList	E_MONTH_ARR	月发电量
keyList	E_YEAR_ARR	年发电量
keyList	E_TILL_NOW_ARR	总发电量
keyList	DC_CURRENT_ARR	汇流箱电流（日）
keyList	POWER_ARR	汇流箱功率（日）
keyList	UNIT_E_DAY_ARR	日单位发电量
keyList	UNIT_E_MONTH_ARR	月单位发电量
keyList	UNIT_E_YEAR_ARR	年单位发电量
keyList	UNIT_E_TILL_NOW_ARR	总单位发电量
keyList	DC_CURRENT_ARR	支路电流（日）
keyList	POWER_ARR	支路功率（日）

请求参数

名称	位置	类型	必选	说明
combinerboxId	query	string	是	汇流箱 ID
date	query	string	是	时间
keyList	query	string	是	图表对应 key 值
isIDC	query	string	否	none

返回示例

200 Response

{
  "success": true,
  "message": "string",
  "code": 0,
  "result": {
    "E_YEAR_ARR": "[{\"time\":\"1\",\"value\":0.0},{\"time\":\"2\",\"value\":0.0},{\"time\":\"3\",\"value\":378.90704166666677},{\"time\":\"4\",\"value\":0.0},{\"time\":\"5\",\"value\":0.0},{\"time\":\"6\",\"value\":0.0},{\"time\":\"7\",\"value\":0.0},{\"time\":\"8\",\"value\":0.0},{\"time\":\"9\",\"value\":0.0},{\"time\":\"10\",\"value\":0.0},{\"time\":\"11\",\"value\":0.0},{\"time\":\"12\",\"value\":0.0}]"
  },
  "timestamp": 0
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	object	true	none		none
»» E_YEAR_ARR	string	true	none	年发电量 JSON	none
» timestamp	integer	true	none		none

汇流箱离线统计

接口描述

根据 汇流箱 id,日期,keyList 获取汇流箱离线数据

请求方式

POST

请求方法

/sol_monitor/iot/combinerBox

请求参数

名称	位置	类型	必选	说明
combinerboxId	query	string	是	汇流箱 ID
date	query	string	是	日期
isEnergy	query	string	是	是否是储能
keyList	query	string	是	key 值

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "WEEK_OFFLINE": "0",
    "YEAR_OFFLINE": "1",
    "TOTAL_OFFLINE": "1",
    "MONTH_OFFLINE": "1",
    "YEAR_OFFLINE_ARR": "[{\"time\":\"1\",\"value\":0.0},{\"time\":\"2\",\"value\":0.0},{\"time\":\"3\",\"value\":1.0},{\"time\":\"4\",\"value\":0.0},{\"time\":\"5\",\"value\":0.0},{\"time\":\"6\",\"value\":0.0},{\"time\":\"7\",\"value\":0.0},{\"time\":\"8\",\"value\":0.0},{\"time\":\"9\",\"value\":0.0},{\"time\":\"10\",\"value\":0.0},{\"time\":\"11\",\"value\":0.0},{\"time\":\"12\",\"value\":0.0}]"
  },
  "timestamp": 1742377882621
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	object	true	none		none
»» WEEK_OFFLINE	string	true	none	本周离线次数	none
»» YEAR_OFFLINE	string	true	none	当年离线次数	none
»» TOTAL_OFFLINE	string	true	none	全部离线次数	none
»» MONTH_OFFLINE	string	true	none	当月离线次数	none
»» YEAR_OFFLINE_ARR	string	true	none	年离线统计图表 JSON	none
» timestamp	integer	true	none		none

汇流箱当日设备数据

接口描述

根据 汇流箱 ID,日期类型,时间 获取汇流箱当日设备数据

请求方式

GET

请求方法

/sol_monitor/combiner/branch/dataList

请求参数

名称	位置	类型	必选	说明
coombinerBoxId	query	string	是	汇流箱 ID
dataType	query	string	是	日期类型
date	query	string	是	日期
pageNum	query	string	是	页码
pageSize	query	string	是	页数

返回示例

200 Response

{
  "success": true,
  "message": "string",
  "code": 0,
  "result": {
    "total": 0,
    "data": [
      {
        "id": 0,
        "createTime": "string",
        "updateTime": "string",
        "inverterId": 0,
        "parentId": null,
        "deviceSn": null,
        "arrayName": "string",
        "arrayBrand": "string",
        "arrayModel": "string",
        "arrayPhysicsName": "string",
        "arrayCount": 0,
        "arrayCapacity": null,
        "arrayEnergy": null,
        "arrayEnerggyPerWatt": null,
        "upv": null,
        "ipv": null,
        "power": null,
        "interventionState": 0,
        "isDelete": 0,
        "modelId": 0,
        "brandId": 0,
        "branchCapacity": 0,
        "type": 0,
        "isAlarm": null,
        "dataUpdateDate": null,
        "keepYears": null,
        "keepStartTime": null,
        "keepEndTime": null,
        "alarmStatus": null,
        "areaDivideId": null,
        "areaDivideName": null,
        "equivalentGenerationHours": null,
        "subList": null,
        "childList": null,
        "moduleCount": null,
        "inverterName": null,
        "inverterSn": null,
        "moduleList": null,
        "arrayNumber": null
      }
    ]
  },
  "timestamp": 0
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	object	true	none		none
»» total	integer	true	none		none
»» data	[object]	true	none		none
»»» id	integer	true	none	ID	none
»»» createTime	string	true	none	创建时间	none
»»» updateTime	string	true	none	更新时间	none
»»» inverterId	integer	true	none	逆变器 ID	none
»»» parentId	null	true	none		none
»»» deviceSn	null	true	none	设备 SN	none
»»» arrayName	string	true	none	组串	none
»»» arrayBrand	string	true	none	组件品牌	none
»»» arrayModel	string	true	none	组件型号	none
»»» arrayPhysicsName	string	true	none	支路	none
»»» arrayCount	integer	true	none	组件数量	none
»»» arrayCapacity	null	true	none	组串容量	none
»»» arrayEnergy	null	true	none	发电量(度)	none
»»» arrayEnerggyPerWatt	null	true	none	单位发电量	none
»»» upv	null	true	none	电压	none
»»» ipv	null	true	none	电流	none
»»» power	null	true	none	功率	none
»»» interventionState	integer	true	none	接入状态	none
»»» isDelete	integer	true	none		none
»»» modelId	integer	true	none	型号 ID	none
»»» brandId	integer	true	none	品牌 ID	none
»»» branchCapacity	integer	true	none	支路容量	none
»»» type	integer	true	none	类型	none
»»» isAlarm	null	true	none	是否告警	none
»»» dataUpdateDate	null	true	none	数据更新时间	none
»»» keepYears	null	true	none	质保时长(年)	none
»»» keepStartTime	null	true	none	质保开始时间	none
»»» keepEndTime	null	true	none	质保结束时间	none
»»» alarmStatus	null	true	none	告警状态	none
»»» areaDivideId	null	true	none	区域划分 ID	none
»»» areaDivideName	null	true	none	区域划分名称	none
»»» equivalentGenerationHours	null	true	none	等效发电小时	none
»»» subList	null	true	none	电表列表	none
»»» childList	null	true	none		none
»»» moduleCount	null	true	none	组件片数	none
»»» inverterName	null	true	none	逆变器名称	none
»»» inverterSn	null	true	none	逆变器 SN	none
»»» moduleList	null	true	none	组件列表	none
»»» arrayNumber	null	true	none	组串数量	none
» timestamp	integer	true	none		none