数据查询
POST
/cloud/api/v1/analysis/query
能源柜接口文档
概述
接口地址
GET /api/energy-cabinet/data请求参数
主请求对象
{
"energyCabinetId": 整数,
"columns": {
"timeInterval": {
"startTime": "ISO8601日期时间字符串",
"endTime": "ISO8601日期时间字符串"
},
"columns": {
"MG-DCDC": 字符串数组,
"MG-DCAC": 字符串数组 // 可选
}
}
}| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| energyCabinetId | 整数 | 是 | 能源柜的唯一标识符 |
| columns | 对象 | 是 | 数据检索配置 |
| timeInterval | 对象 | 是 | 数据检索的时间范围 |
| startTime | 字符串 | 是 | ISO8601格式的开始时间（带时区） |
| endTime | 字符串 | 是 | ISO8601格式的结束时间（带时区） |
| columns | 对象 | 是 | 要检索的列组 |
| MG-DCDC | 数组 | 否 | DCDC模块列名数组 |
| MG-DCAC | 数组 | 否 | DCAC模块列名数组 |
可用列
MG-DCDC
| 列名 | 描述 | 单位 | 示例 |
|---|---|---|---|
| id | 记录ID | - | - |
| create_time | 创建时间 | - | - |
| data_time | 数据时间 | - | - |
| dcdc_count | DCDC模块总数 | - | 5 |
| dcdc_online_count | 在线DCDC模块数量 | - | 5 |
| low_voltage_current | 低压侧电流 | A | 10 |
| low_voltage_power | 低压侧功率 | kW | 5.5 |
| high_voltage_current | 高压侧电流 | A | 7.1 |
| high_voltage_power | 高压侧功率 | kW | 5.5 |
| work_mode | DCDC模块工作模式 | - | - |
| boost_or_buck | 升/降压模式 | - | - |
| total_charge | 总充电量 | kWh | 0 |
| total_discharge | 总放电量 | kWh | 2176.4 |
| today_charge | 当日充电量 | kWh | 0 |
| today_discharge | 当日放电量（PV发电量） | kWh | 297.2 |
| month_charge | 当月充电量 | kWh | 0 |
| month_discharge | 当月放电量（PV发电量） | kWh | 1975 |
| year_charge | 年总充电量 | kWh | 6350.1 |
| year_discharge | 年总放电量（PV发电量） | kWh | 2176.4 |
MG-DCAC
| 列名 | 描述 | 单位 | 示例 |
|---|---|---|---|
| id | 记录ID | - | - |
| create_time | 创建时间 | - | - |
| data_time | 数据时间 | - | - |
| working_mode | 工作模式 | - | - |
| inverter_voltage_ab | 逆变电压AB | V | 206.2 |
| inverter_voltage_bc | 逆变电压BC | V | 206.6 |
| inverter_voltage_ca | 逆变电压CA | V | 207.2 |
| inverter_current_a | 逆变电流A | A | 26.7 |
| inverter_current_b | 逆变电流B | A | 24.6 |
| inverter_current_c | 逆变电流C | A | 60.6 |
| inverter_frequency | 逆变频率 | Hz | 50.06 |
| inverter_total_active_power | 逆变总有功功率 | kW | 11.5 |
| load_line_voltage_ab | 负载线电压AB | V | 408.9 |
| load_line_voltage_bc | 负载线电压BC | V | 410.5 |
| load_line_voltage_ca | 负载线电压CA | V | 411.7 |
| load_current_a | 负载电流A | A | 12.3 |
| load_current_b | 负载电流B | A | 12.3 |
| load_current_c | 负载电流C | A | 35.9 |
| load_frequency | 负载频率 | Hz | 50.06 |
| load_power_factor | 负载功率因数 | - | 0.98 |
| load_total_active_power | 负载总有功功率 | kW | 14 |
| load_total_reactive_power | 负载总无功功率 | kVar | -2.6 |
| load_total_apparent_power | 负载总视在功率 | kVA | 14.2 |
| grid_line_voltage_ab | 电网线电压AB | V | 408.9 |
| grid_line_voltage_bc | 电网线电压BC | V | 409.7 |
| grid_line_voltage_ca | 电网线电压CA | V | 410.9 |
| grid_current_a | 电网电流A | A | -5.2 |
| grid_current_b | 电网电流B | A | -8.4 |
| grid_current_c | 电网电流C | A | -9.1 |
| grid_frequency | 电网频率 | Hz | 49.98 |
| grid_active_power_factor | 电网功率因数 | - | 0.99 |
| grid_total_active_power | 电网总有功功率 | kW | -2.6 |
| grid_total_reactive_power | 电网总无功功率 | kVar | 0 |
| grid_apparent_power | 电网总视在功率 | kVA | 2.4 |
| bus_voltage | 母线电压 | V | 803.3 |
| bus_current | 母线电流 | A | 17 |
| bus_power | 母线功率 | kW | 13.7 |
| battery_voltage | 电池电压 | V | 801.1 |
| battery_current | 电池电流 | A | 2.5 |
| battery_power | 电池功率 | kW | 2 |
| igbt_temperature | IGBT温度 | °C | 42 |
| env_temperature | 环境温度 | °C | 25 |
| today_battery_discharge | 当日电池放电量 | kWh | 79.5 |
| today_load_electricity | 当日负载用电量 | kWh | 235.1 |
| month_battery_discharge | 当月电池放电量 | kWh | 801.5 |
| month_load_electricity | 当月负载用电量 | kWh | 2119.1 |
| year_battery_discharge | 当年电池放电量 | kWh | 1036.9 |
| year_load_electricity | 当年负载用电量 | kWh | 2332 |
| total_battery_discharge | 总电池放电量 | kWh | 1036.9 |
| total_load_electricity | 总负载用电量 | kWh | 2332 |
| battery_status | 电池工作状态 | - | 电池充满 |
| max_charge_current | 最大充电电 流 | A | 0 |
| max_discharge_current | 最大放电电流 | A | 330 |
| total_battery_voltage | 电池电压 | V | 799 |
| total_battery_current | 电池电流 | A | 3 |
| battery_soc | 电池SOC | % | 99 |
| battery_soh | 电池SOH | % | 100 |
| single_max_voltage | 单体最大电压 | mV | 3334 |
| single_min_voltage | 单体最小电压 | mV | 3328 |
| single_max_temperature | 单体最高温度 | °C | 24 |
| single_min_temperature | 单体最低温度 | °C | 21 |
| max_allow_charge_power | 最大允许充电功率 | kW | 0 |
| max_allow_discharge_power | 最大允许放电功率 | kW | 230 |
| battery_contactor | 电池接触器 | - | 闭合 |
注意事项
1.
2.
3.
4.
请求参数
Body 参数application/json
返回响应
修改于 2025-05-20 06:37:24