Document description
Interface documentation
Modification record
Global error code
Interface display
User correlation
Power station relate
Equipment related
Device type description
3.1 Add collector
3.2 Delete collector
3.3 Obtain a power station equipment list
3.4 Get a list of power station collectors
3.5 Query device type according to SN
3.6 Check whether the collector SN and check code
3.41 Obtaining the historical power generation of
3.43 Query collector based on SN
Get device creation dates in batches (from October
Add device associated account interface
Inverter
Energy storage machi
Energy storage machine parameter setting
Get basic information of energy storage machine
Get the latest real-time data of the energy storag
Obtain historical data of an energy storage machin
Get the alarm data of a certain energy storage mac
Read energy storage machine setting parameter inte
Max
SPH
spa
Min
Pcs
Hps
Pbd
Smart meter
Environmental tester
VPP
GroBoost

ShineServer_English version


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>

页面列表

ITEM_HTML