Obtain historical data of an energy storage machin
<p><strong>A brief description:</strong> </p>
<p>-An interface for obtaining historical data of a certain energy storage machine
-<code>Only applicable to devices with device type 2 returned in the 3.3 interface.</code></p>
<p><strong>Request URL:</strong>
-<code>http(s)://test.growatt.com/v1/device/storage/storage_data</code></p>
<p><strong>How to request:</strong>
-post</p>
<p><strong>Parameter:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter name</th>
<th style="text-align: left;">Is it required</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">storage_sn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">string</td>
<td>Energy storage device SN</td>
</tr>
<tr>
<td style="text-align: left;">start_date</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">time</td>
<td>start date</td>
</tr>
<tr>
<td style="text-align: left;">end_date</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">time</td>
<td>End date, with a maximum interval of 7 days between start/end time</td>
</tr>
<tr>
<td style="text-align: left;">timezone_id</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>The time zone code of the data display, the default is UTC</td>
</tr>
<tr>
<td style="text-align: left;">perpage</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>Number per page, default 20, maximum 100</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>Number of pages</td>
</tr>
</tbody>
</table>
<p><strong>Return example</strong></p>
<pre><code>{
"data": {
"datas": [
{
"eDischargeToday": 0,
"cell2Voltage10": 0,
"bmsSoh": 0,
"cell2Voltage12": 0,
"cell2Voltage11": 0,
"chargeMonth": 0,
"outPutCurrent": 0,
"temperature": 33.599998474121094,
"eDischargeTotal2": 1.7,
"time": "2019-01-13 23:58:32",
"cell2Voltage13": 0,
"cell2Voltage14": 0,
"cell2Voltage15": 0,
"cell2Voltage16": 0,
"pCharge2": 0,
"pDischarge": 0,
"freqOutPut": 0,
"cellVoltage16": 0,
"bmsCurrent": 0,
"cellVoltage15": 0,
"cycleCount": 0,
"maxChargeOrDischargeCurrent": 0,
"vGrid": 0,
"ppv": 0,
"bmsCellVoltage10": 0,
"iacToUserText": "0.0 A",
"iacToGrid": 0,
"bmsCellVoltage14": 0,
"bmsCellVoltage13": 0,
"bmsCellVoltage12": 0,
"vpv2": 1.100000023841858,
"bmsCellVoltage11": 0,
"eChargeToday": 0,
"bmsCellVoltage16": 0,
"bmsCellVoltage15": 0,
"eToUserToday": 11.7,
"vpvText": "0.3 V",
"innerCWCode": "0_0",
"iChargePV2": 0,
"iChargePV1": 0,
"pacToUser": 0,
"deviceType": 0,
"cellVoltage11": 0,
"eDischargeTotal": 1.7,
"cellVoltage12": 0,
"cellVoltage13": 0,
"cellVoltage14": 0,
"cellVoltage10": 0,
"dischargeToStandbyReason": 5,
"remoteCntlFailReason": 0,
"etotal": 1043.1000000000001,
"cell2Voltage1": 0,
"cell2Voltage2": 0,
"cell2Voltage3": 0,
"cell2Voltage4": 0,
"iacToUser": 0,
"cell2Voltage5": 0,
"eChargeTodayText": "0.0 kWh",
"cell2Voltage6": 0,
"cell2Voltage7": 0,
"cell2Voltage8": 0,
"cell2Voltage9": 0,
"pCharge": 0,
"outPutVolt": 0,
"eToGridTotal": 7648481.6,
"constantVolt": 0,
"chargeWay": 0,
"vBus": 1.600000023841858,
"ipv": 0,
"constantVolt2": 0,
"vBatText": "50.2 V",
"dischargeToStandbyReasonText": "Reason of state change from discharge to operating: Battery voltage low for discharge",
"eDischargeTotalText": "1.7 kWh",
"epvToday2": 6.1,
"serialNum": "JZB674901B",
"dayMap": null,
"iAcCharge": 0,
"pacToGridText": "0.0 W",
"etoday": 12.8,
"bmsTemperature2": 0,
"chargeToStandbyReasonText": "Reason of state change from charge to operating: Battery voltage high for charge",
"chgCurr": 0,
"faultCode": 0,
"day": "",
"gaugeICCurrent": 0,
"bmsWarnInfo": 0,
"bmsCurrent2": 0,
"ppvText": "0.0 W",
"withTime": false,
"iCharge": 0,
"calendar": {
"minimalDaysInFirstWeek": 1,
"time": {
"time": 1547395112000,
"minutes": 58,
"seconds": 32,
"hours": 23,
"month": 0,
"timezoneOffset": -480,
"year": 119,
"day": 0,
"date": 13
},
"weekYear": 2019,
"weeksInWeekYear": 52,
"gregorianChange": {
"time": -12219292800000,
"minutes": 0,
"seconds": 0,
"hours": 8,
"month": 9,
"timezoneOffset": -480,
"year": -318,
"day": 5,
"date": 15
},
"timeZone": {
"lastRuleInstance": null,
"DSTSavings": 0,
"rawOffset": 28800000,
"ID": "Asia/Shanghai",
"dirty": false,
"displayName": "中国标准时间"
},
"lenient": true,
"timeInMillis": 1547395112000,
"firstDayOfWeek": 1,
"weekDateSupported": true
},
"vBuck": 0.800000011920929,
"eToGridToday": 0,
"powSavingEn": 0,
"vac": 227.60000610351562,
"vBuckText": "0.8 V",
"bLightEn": 0,
"gaugeRM1": 0,
"gaugeRM2": 0,
"eacChargeTotal": 2.1,
"eacDisChargeTotal": 0,
"epvToday": 6.7,
"errorText": "Unknown",
"eChargeToday2": 0,
"gaugePackStatus": 0,
"warnInfo2": 0,
"pDischarge2": 0,
"chargeToStandbyReason": 5,
"again": false,
"ipmTemperature": 33.599998474121094,
"uwBatType2": 0,
"pacToUserText": "0.0 W",
"soh": 0,
"bmsCellVoltage1": 0,
"remoteCntlEn": 0,
"bmsCellVoltage3": 0,
"bmsCellVoltage2": 0,
"eopDischrTotal": 0,
"bmsCellVoltage6": 0,
"bmsCellVoltage7": 0,
"bmsCellVoltage4": 0,
"bmsCellVoltage5": 0,
"bmsCellVoltage8": 0,
"eDischargeTodayText": "0.0 kWh",
"bmsCellVoltage9": 0,
"gaugeBattteryStatus": 0,
"normalPower": 0,
"iDischarge": 0,
"rateVA": 0,
"capacity": 52,
"manualStartEn": 0,
"eacChargeToday": 0,
"ipvText": "0.0 A",
"dataLogSn": "",
"bmsError": 0,
"epvTotal": 536.3,
"pacToGrid": 0,
"eopDischrToday": 0,
"pAcInPut": 0,
"eChargeTotal2": 2.6,
"batTemp": 34.400001525878906,
"bmsStatus": 0,
"warnInfo": 0,
"iChargeText": "0.0 A",
"deltaVolt": 0,
"pDischargeText": "0.0 W",
"disChargeMonth": 0,
"vacText": "227.6 V",
"errorCode": 0,
"maxChargeOrDischargeCurrent2": 0,
"rateWatt": 0,
"eChargeTotal": 2.3,
"cellVoltage1": 0,
"cellVoltage3": 0,
"cellVoltage2": 0,
"bmsTemperature": 0,
"cellVoltage9": 0,
"cellVoltage8": 0,
"cellVoltage5": 0,
"eToUserTotal": 24137113.8,
"cellVoltage4": 0,
"cellVoltage7": 0,
"pBat": 0,
"cellVoltage6": 0,
"warnCode": 0,
"iDischargeText": "0.0 A",
"gaugeOperationStatus": 0,
"eBatDisChargeToday": 0,
"bmsDeltaVolt": 0,
"bmsError2": 0,
"gauge2RM2": 0,
"gauge2RM1": 0,
"vBuck2": 0.5,
"sysOut": 0,
"status": 0,
"storageBean": null,
"loadPercent": 0,
"pAcCharge": 0,
"epvTotal2": 508.3,
"pChargeText": "0.0 W",
"eDischargeToday2": 0,
"freqGrid": 0,
"lost": true,
"outPutPower": 0,
"statusText": "Operating",
"eacDisChargeToday": 0,
"eChargeTotalText": "2.3 kWh",
"warnText": "Unknown",
"vBat": 50.20000076293945,
"deltaVolt2": 0,
"cycleCount2": 0,
"soh2": 0,
"iacToGridText": "0.0 A",
"eBatDisChargeTotal": 0,
"alias": "",
"dischgCurr": 0,
"bmsStatus2": 0,
"capacityText": "52 %",
"address": 0,
"bmsConstantVolt": 0,
"ppv2": 0,
"sciLossChkEn": 0,
"vpv": 0.30000001192092896
}
],
"next_page_start_id": 21,
"count": 289,
"storage_sn": "JZB674901B",
"datalogger_sn": "IUB38210F9"
},
"error_code": 0,
"error_msg": ""
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">storage_sn</td>
<td style="text-align: left;">string</td>
<td>储能机设备SN</td>
</tr>
<tr>
<td style="text-align: left;">next_page_start_id</td>
<td style="text-align: left;">string</td>
<td>下一页起始ID</td>
</tr>
<tr>
<td style="text-align: left;">datalogger_sn</td>
<td style="text-align: left;">string</td>
<td>设备对应的采集器SN</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string</td>
<td>储能机状态（0：Operating，1：Charge，2：Discharge，3：Fault，4：Flash）</td>
</tr>
<tr>
<td style="text-align: left;">deviceType</td>
<td style="text-align: left;">string</td>
<td>储能机类型（0：SP2000,1：SP3000）</td>
</tr>
<tr>
<td style="text-align: left;">pCharge</td>
<td style="text-align: left;">string</td>
<td>Charging power (W)</td>
</tr>
<tr>
<td style="text-align: left;">pDischarge</td>
<td style="text-align: left;">string</td>
<td>Discharge power (W)</td>
</tr>
<tr>
<td style="text-align: left;">vpv</td>
<td style="text-align: left;">string</td>
<td>Input PV voltage (V)</td>
</tr>
<tr>
<td style="text-align: left;">ipv</td>
<td style="text-align: left;">string</td>
<td>Input PV current (A)</td>
</tr>
<tr>
<td style="text-align: left;">iCharge</td>
<td style="text-align: left;">string</td>
<td>PV terminal charging current (A)</td>
</tr>
<tr>
<td style="text-align: left;">iDischarge</td>
<td style="text-align: left;">string</td>
<td>PV end discharge current (A)</td>
</tr>
<tr>
<td style="text-align: left;">ppv</td>
<td style="text-align: left;">string</td>
<td>Panel input power (W)</td>
</tr>
<tr>
<td style="text-align: left;">vBuck</td>
<td style="text-align: left;">string</td>
<td>vBuk (A)</td>
</tr>
<tr>
<td style="text-align: left;">vac</td>
<td style="text-align: left;">string</td>
<td>Grid voltage (V)</td>
</tr>
<tr>
<td style="text-align: left;">iacToUser</td>
<td style="text-align: left;">string</td>
<td>User side current (A)</td>
</tr>
<tr>
<td style="text-align: left;">pacToUser</td>
<td style="text-align: left;">string</td>
<td>User-side power (V)</td>
</tr>
<tr>
<td style="text-align: left;">iacToGrid</td>
<td style="text-align: left;">string</td>
<td>Grid side current (A)</td>
</tr>
<tr>
<td style="text-align: left;">pacToGrid</td>
<td style="text-align: left;">string</td>
<td>Grid side power (W)</td>
</tr>
<tr>
<td style="text-align: left;">vBat</td>
<td style="text-align: left;">string</td>
<td>Battery voltage (V)</td>
</tr>
<tr>
<td style="text-align: left;">capacity</td>
<td style="text-align: left;">string</td>
<td>Battery capacity (percent)</td>
</tr>
<tr>
<td style="text-align: left;">ipmTemperature</td>
<td style="text-align: left;">string</td>
<td>IPM temperature (℃)</td>
</tr>
<tr>
<td style="text-align: left;">epvToday</td>
<td style="text-align: left;">string</td>
<td>Panel power of the day (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">epvTotal</td>
<td style="text-align: left;">string</td>
<td>Total panel power (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">temperature</td>
<td style="text-align: left;">string</td>
<td>temperature (℃)</td>
</tr>
<tr>
<td style="text-align: left;">eChargeToday</td>
<td style="text-align: left;">string</td>
<td>Charge energy of the day (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eChargeTotal</td>
<td style="text-align: left;">string</td>
<td>Total charging energy (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">string</td>
<td>Data time</td>
</tr>
<tr>
<td style="text-align: left;">eDischargeToday</td>
<td style="text-align: left;">string</td>
<td>Discharge energy of the day (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eDischargeTotal</td>
<td style="text-align: left;">string</td>
<td>Total discharge energy (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eToUserToday</td>
<td style="text-align: left;">string</td>
<td>How much electricity (kWh) the current day (grid-user)</td>
</tr>
<tr>
<td style="text-align: left;">eToUserTotal</td>
<td style="text-align: left;">string</td>
<td>Total (grid-user) how much electricity (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eToGridToday</td>
<td style="text-align: left;">string</td>
<td>How much electricity (kWh) the current day (user-grid)</td>
</tr>
<tr>
<td style="text-align: left;">eToGridTotal</td>
<td style="text-align: left;">string</td>
<td>Total (user-grid) how much electricity (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">faultCode</td>
<td style="text-align: left;">string</td>
<td>error code</td>
</tr>
<tr>
<td style="text-align: left;">vpv2</td>
<td style="text-align: left;">string</td>
<td>SP3000 Input PV voltage (V)</td>
</tr>
<tr>
<td style="text-align: left;">ppv2</td>
<td style="text-align: left;">string</td>
<td>SP3000 panel input power (W)</td>
</tr>
<tr>
<td style="text-align: left;">ipv</td>
<td style="text-align: left;">string</td>
<td>SP3000 Charging power (W)</td>
</tr>
<tr>
<td style="text-align: left;">pDischarge2</td>
<td style="text-align: left;">string</td>
<td>SP3000 Discharge power (W)</td>
</tr>
<tr>
<td style="text-align: left;">vBuck2</td>
<td style="text-align: left;">string</td>
<td>vBuck2 (A)</td>
</tr>
<tr>
<td style="text-align: left;">epvToday2</td>
<td style="text-align: left;">string</td>
<td>SP3000 The current panel power (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">epvTotal2</td>
<td style="text-align: left;">string</td>
<td>SP3000 panel cumulative power (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eChargeToday2</td>
<td style="text-align: left;">string</td>
<td>SP3000 today's charging power (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eChargeTotal2</td>
<td style="text-align: left;">string</td>
<td>SP3000 accumulative charging power (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eDischargeToday2</td>
<td style="text-align: left;">string</td>
<td>SP3000 Discharge Today (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">eDischargeTotal2</td>
<td style="text-align: left;">string</td>
<td>SP3000 cumulative discharge (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">normalPower</td>
<td style="text-align: left;">string</td>
<td>Current power (W)</td>
</tr>
<tr>
<td style="text-align: left;">errorCode</td>
<td style="text-align: left;">string</td>
<td>error code</td>
</tr>
<tr>
<td style="text-align: left;">warnCode</td>
<td style="text-align: left;">string</td>
<td>Warn Code</td>
</tr>
<tr>
<td style="text-align: left;">iChargePV1</td>
<td style="text-align: left;">string</td>
<td>PV1 charging current</td>
</tr>
<tr>
<td style="text-align: left;">iChargePV2</td>
<td style="text-align: left;">string</td>
<td>PV2 charging current</td>
</tr>
<tr>
<td style="text-align: left;">outPutPower</td>
<td style="text-align: left;">string</td>
<td>Output power</td>
</tr>
<tr>
<td style="text-align: left;">pAcCharge</td>
<td style="text-align: left;">string</td>
<td>AC charging power</td>
</tr>
<tr>
<td style="text-align: left;">vGrid</td>
<td style="text-align: left;">string</td>
<td>Mains voltage</td>
</tr>
<tr>
<td style="text-align: left;">freqGrid</td>
<td style="text-align: left;">string</td>
<td>Mains frequency</td>
</tr>
<tr>
<td style="text-align: left;">outPutVolt</td>
<td style="text-align: left;">string</td>
<td>Output voltage</td>
</tr>
<tr>
<td style="text-align: left;">freqOutPut</td>
<td style="text-align: left;">string</td>
<td>Output frequency</td>
</tr>
<tr>
<td style="text-align: left;">loadPercent</td>
<td style="text-align: left;">string</td>
<td>Percentage of load</td>
</tr>
<tr>
<td style="text-align: left;">outPutCurrent</td>
<td style="text-align: left;">string</td>
<td>Output current</td>
</tr>
<tr>
<td style="text-align: left;">eacChargeToday</td>
<td style="text-align: left;">string</td>
<td>AC charging energy of the day</td>
</tr>
<tr>
<td style="text-align: left;">eacChargeTotal</td>
<td style="text-align: left;">string</td>
<td>AC total charging energy</td>
</tr>
<tr>
<td style="text-align: left;">eBatDisChargeToday</td>
<td style="text-align: left;">string</td>
<td>Battery discharge energy on the day</td>
</tr>
<tr>
<td style="text-align: left;">eBatDisChargeTotal</td>
<td style="text-align: left;">string</td>
<td>Total battery discharge energy</td>
</tr>
<tr>
<td style="text-align: left;">eacDisChargeToday</td>
<td style="text-align: left;">string</td>
<td>Bypass load energy on the day of the utility</td>
</tr>
<tr>
<td style="text-align: left;">eacDisChargeTotal</td>
<td style="text-align: left;">string</td>
<td>Mains total bypass load energy</td>
</tr>
<tr>
<td style="text-align: left;">iAcCharge</td>
<td style="text-align: left;">string</td>
<td>AC charging current</td>
</tr>
<tr>
<td style="text-align: left;">pAcInPut</td>
<td style="text-align: left;">string</td>
<td>AC input energy</td>
</tr>
<tr>
<td style="text-align: left;">pBat</td>
<td style="text-align: left;">string</td>
<td>Battery power</td>
</tr>
<tr>
<td style="text-align: left;">InvTemperature</td>
<td style="text-align: left;">float</td>
<td>InvTemp</td>
</tr>
<tr>
<td style="text-align: left;">DcDcTemperature</td>
<td style="text-align: left;">float</td>
<td>DcDc Temp</td>
</tr>
<tr>
<td style="text-align: left;">Buck1_NTCTemperature</td>
<td style="text-align: left;">float</td>
<td>Buck1 Temperature</td>
</tr>
<tr>
<td style="text-align: left;">Buck2_NTCTemperature</td>
<td style="text-align: left;">float</td>
<td>Buck2 Temperature</td>
</tr>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">string</td>
<td>0: normal return, 10001: system error, 10002: device serial number error, 10003: date format error, 10004: date interval exceeds seven days, 10005: energy storage machine does not exist</td>
</tr>
<tr>
<td style="text-align: left;">error_msg</td>
<td style="text-align: left;">string</td>
<td>Error message prompt</td>
</tr>
</tbody>
</table>
<p><strong>Remarks</strong></p>
<p>-The frequency of acquisition is once every 10 seconds</p>