Get historical data of a GroBoost
<p><strong>A brief description:</strong> </p>
<p>-An interface to obtain historical data of a GroBoost
-<code>Only applicable to devices whose device type is 11 returned in the 3.3 interface.</code></p>
<p><strong>Request URL:</strong>
-http(s)://test.growatt.com/v1/device/boost/boost_data `</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;">boost_sn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td>Boost Device SN</td>
</tr>
<tr>
<td style="text-align: left;">start_date</td>
<td style="text-align: left;">is</td>
<td style="text-align: left;">String</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;">String</td>
<td>End date (the date interval cannot exceed 7 days)</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</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 of pages 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": [
{
"fwVersion": "1.0.0.0",
"bfreq": 0,
"bonOff": 0,
"addr": 84,
"cloadNormalPower": 360,
"bppv": 0,
"temperature": 0,
"aminTemp": 40,
"cipv": 0,
"powerFactor": 0,
"loadPriority": 0,
"btotalEnergy": 0,
"totalNumber": 0,
"power": 0,
"rs485BaudRate": 2,
"serialNum": "GRO2020102",
"cppv": 0,
"status": 0,
"cminTemp": 40,
"atotalEnergy": 0,
"bmaxTemp": 65,
"ctime": null,
"cfreq": 0,
"bminTemp": 40,
"sysTime": "2021-05-11 14:41:34",
"appv": 0,
"targetPower": 3600,
"voltage": 0,
"dryContactStatus": 0,
"temp": 0,
"dpower": 0,
"aipv": 0,
"minTime": 0,
"avpv": 0,
"dtotalEnergy": 0,
"loadDeviceType": 0,
"btemp": 0,
"atime": null,
"afreq": 0,
"ajobsModel": 3,
"bipv": 0,
"rfCommand": "014207",
"astartPower": 0,
"rs485Addr": 1,
"version": "9.1.0.2",
"tuningState": 0,
"asetPower": 0,
"totalEneny": 0,
"waterState": 0,
"ctotalEnergy": 0,
"dryContactTime": null,
"deviceType": "69",
"current": 0,
"cmaxTemp": 65,
"withTime": false,
"bloadNormalPower": 360,
"timeText": "2021-05-11 14:29:07",
"dataLogSn": "NACTEST128",
"amaxTemp": 65,
"calendar": {
"minimalDaysInFirstWeek": 1,
"time": {
"time": 1620714547000,
"minutes": 29,
"seconds": 7,
"hours": 14,
"month": 4,
"timezoneOffset": -480,
"year": 121,
"day": 2,
"date": 11
},
"weekYear": 2021,
"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": "China Standard Time"
},
"lenient": true,
"timeInMillis": 1620714547000,
"firstDayOfWeek": 1,
"weekDateSupported": true
},
"restart": 0,
"rfPair": 0,
"btime": null,
"resetFactory": 255,
"bvpv": 0,
"aloadNormalPower": 360,
"atemp": 127,
"v9420Status": 0,
"maxTemp": 100,
"cstartPower": 0,
"waterHeaterPower": 360,
"cvpv": 0,
"aonOff": 0,
"tempEnable": 1,
"dryContactOnOff": 0,
"bstartPower": 0,
"jobsModel": 0,
"ctemp": 0,
"conOff": 0
}
],
"next_page_start_id": 21,
"count": 254,
"boost_sn": "GRO2020102",
"datalogger_sn": "NACTEST128"
},
"error_code": 0,
"error_msg": ""
}</code></pre>
<p><strong>Return parameter description</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Parameter name</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">dataloggerSn</td>
<td style="text-align: left;">string</td>
<td>Owning collector SN</td>
</tr>
<tr>
<td style="text-align: left;">fwVersion</td>
<td style="text-align: left;">string</td>
<td>Hardware version</td>
</tr>
<tr>
<td style="text-align: left;">bfreq</td>
<td style="text-align: left;">string</td>
<td>Phase B frequency</td>
</tr>
<tr>
<td style="text-align: left;">bonOff</td>
<td style="text-align: left;">int</td>
<td>B road timer switch</td>
</tr>
<tr>
<td style="text-align: left;">addr</td>
<td style="text-align: left;">int</td>
<td>address</td>
</tr>
<tr>
<td style="text-align: left;">cloadNormalPower</td>
<td style="text-align: left;">string</td>
<td>C load rated power</td>
</tr>
<tr>
<td style="text-align: left;">bppv</td>
<td style="text-align: left;">string</td>
<td>B-phase power</td>
</tr>
<tr>
<td style="text-align: left;">temperature</td>
<td style="text-align: left;">int</td>
<td>temperature</td>
</tr>
<tr>
<td style="text-align: left;">aminTemp</td>
<td style="text-align: left;">string</td>
<td>A minimum temperature</td>
</tr>
<tr>
<td style="text-align: left;">cipv</td>
<td style="text-align: left;">string</td>
<td>C phase current</td>
</tr>
<tr>
<td style="text-align: left;">powerFactor</td>
<td style="text-align: left;">string</td>
<td>Power factor</td>
</tr>
<tr>
<td style="text-align: left;">loadPriority</td>
<td style="text-align: left;">int</td>
<td>ABC phase load priority</td>
</tr>
<tr>
<td style="text-align: left;">totalNumber</td>
<td style="text-align: left;">int</td>
<td>The power adjustment ratio</td>
</tr>
<tr>
<td style="text-align: left;">btotalEnergy</td>
<td style="text-align: left;">string</td>
<td>B-phase total energy</td>
</tr>
<tr>
<td style="text-align: left;">power</td>
<td style="text-align: left;">string</td>
<td>power</td>
</tr>
<tr>
<td style="text-align: left;">serialNum</td>
<td style="text-align: left;">string</td>
<td>Serial Number</td>
</tr>
<tr>
<td style="text-align: left;">rs485BaudRate</td>
<td style="text-align: left;">int</td>
<td>485 baud rate</td>
</tr>
<tr>
<td style="text-align: left;">cppv</td>
<td style="text-align: left;">string</td>
<td>C phase power</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>ABC phase relay status</td>
</tr>
<tr>
<td style="text-align: left;">atotalEnergy</td>
<td style="text-align: left;">string</td>
<td>A phase total energy</td>
</tr>
<tr>
<td style="text-align: left;">cminTemp</td>
<td style="text-align: left;">string</td>
<td>C road temperature minimum</td>
</tr>
<tr>
<td style="text-align: left;">bmaxTemp</td>
<td style="text-align: left;">string</td>
<td>B path temperature maximum</td>
</tr>
<tr>
<td style="text-align: left;">ctime</td>
<td style="text-align: left;">string</td>
<td>C road timing time</td>
</tr>
<tr>
<td style="text-align: left;">bminTemp</td>
<td style="text-align: left;">string</td>
<td>Minimum temperature of channel B</td>
</tr>
<tr>
<td style="text-align: left;">cfreq</td>
<td style="text-align: left;">string</td>
<td>C phase frequency</td>
</tr>
<tr>
<td style="text-align: left;">sysTime</td>
<td style="text-align: left;">string</td>
<td>Time</td>
</tr>
<tr>
<td style="text-align: left;">appv</td>
<td style="text-align: left;">string</td>
<td>A phase power</td>
</tr>
<tr>
<td style="text-align: left;">targetPower</td>
<td style="text-align: left;">int</td>
<td>Adjust the target power</td>
</tr>
<tr>
<td style="text-align: left;">voltage</td>
<td style="text-align: left;">string</td>
<td>voltage</td>
</tr>
<tr>
<td style="text-align: left;">dryContactStatus</td>
<td style="text-align: left;">int</td>
<td>dry contact status</td>
</tr>
<tr>
<td style="text-align: left;">temp</td>
<td style="text-align: left;">string</td>
<td>SCR temperature</td>
</tr>
<tr>
<td style="text-align: left;">dpower</td>
<td style="text-align: left;">string</td>
<td>The total power of phase A under three-phase + single-phase type</td>
</tr>
<tr>
<td style="text-align: left;">aipv</td>
<td style="text-align: left;">string</td>
<td>A phase current</td>
</tr>
<tr>
<td style="text-align: left;">minTime</td>
<td style="text-align: left;">int</td>
<td>Minimum working time</td>
</tr>
<tr>
<td style="text-align: left;">avpv</td>
<td style="text-align: left;">string</td>
<td>Phase A voltage</td>
</tr>
<tr>
<td style="text-align: left;">dtotalEnergy</td>
<td style="text-align: left;">string</td>
<td>Total energy of phase A under three-phase + single-phase type</td>
</tr>
<tr>
<td style="text-align: left;">loadDeviceType</td>
<td style="text-align: left;">int</td>
<td>load device type</td>
</tr>
<tr>
<td style="text-align: left;">btemp</td>
<td style="text-align: left;">string</td>
<td>B road temperature</td>
</tr>
<tr>
<td style="text-align: left;">atime</td>
<td style="text-align: left;">string</td>
<td>A road timing time</td>
</tr>
<tr>
<td style="text-align: left;">afreq</td>
<td style="text-align: left;">string</td>
<td>Phase A frequency</td>
</tr>
<tr>
<td style="text-align: left;">ajobsModel</td>
<td style="text-align: left;">int</td>
<td>A job mode</td>
</tr>
<tr>
<td style="text-align: left;">bipv</td>
<td style="text-align: left;">string</td>
<td>Phase B current</td>
</tr>
<tr>
<td style="text-align: left;">rfCommand</td>
<td style="text-align: left;">string</td>
<td>RF communication channel</td>
</tr>
<tr>
<td style="text-align: left;">astartPower</td>
<td style="text-align: left;">string</td>
<td>A start power</td>
</tr>
<tr>
<td style="text-align: left;">rs485Addr</td>
<td style="text-align: left;">string</td>
<td>485 communication address</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">string</td>
<td>Software version</td>
</tr>
<tr>
<td style="text-align: left;">tuningState</td>
<td style="text-align: left;">int</td>
<td>Tuning state</td>
</tr>
<tr>
<td style="text-align: left;">asetPower</td>
<td style="text-align: left;">string</td>
<td>A set target power</td>
</tr>
<tr>
<td style="text-align: left;">waterState</td>
<td style="text-align: left;">int</td>
<td>Water heater working state</td>
</tr>
<tr>
<td style="text-align: left;">totalEneny</td>
<td style="text-align: left;">string</td>
<td>Total power consumption</td>
</tr>
<tr>
<td style="text-align: left;">ctotalEnergy</td>
<td style="text-align: left;">string</td>
<td>C-phase total energy</td>
</tr>
<tr>
<td style="text-align: left;">deviceType</td>
<td style="text-align: left;">string</td>
<td>Device type</td>
</tr>
<tr>
<td style="text-align: left;">dryContactTime</td>
<td style="text-align: left;">string</td>
<td>Dry contact timing time</td>
</tr>
<tr>
<td style="text-align: left;">current</td>
<td style="text-align: left;">string</td>
<td>current</td>
</tr>
<tr>
<td style="text-align: left;">withTime</td>
<td style="text-align: left;">boolean</td>
<td>Whether to bring time</td>
</tr>
<tr>
<td style="text-align: left;">cmaxTemp</td>
<td style="text-align: left;">string</td>
<td>Maximum temperature of C road</td>
</tr>
<tr>
<td style="text-align: left;">timeText</td>
<td style="text-align: left;">string</td>
<td>time</td>
</tr>
<tr>
<td style="text-align: left;">bloadNormalPower</td>
<td style="text-align: left;">string</td>
<td>B load rated power</td>
</tr>
<tr>
<td style="text-align: left;">dataLogSn</td>
<td style="text-align: left;">string</td>
<td>The serial number of the collector</td>
</tr>
<tr>
<td style="text-align: left;">amaxTemp</td>
<td style="text-align: left;">string</td>
<td>Maximum temperature of channel A</td>
</tr>
<tr>
<td style="text-align: left;">restart</td>
<td style="text-align: left;">int</td>
<td>restart</td>
</tr>
<tr>
<td style="text-align: left;">rfPair</td>
<td style="text-align: left;">int</td>
<td>RF pairing</td>
</tr>
<tr>
<td style="text-align: left;">resetFactory</td>
<td style="text-align: left;">int</td>
<td>Restore factory settings</td>
</tr>
<tr>
<td style="text-align: left;">btime</td>
<td style="text-align: left;">string</td>
<td>B road timing time</td>
</tr>
<tr>
<td style="text-align: left;">aloadNormalPower</td>
<td style="text-align: left;">string</td>
<td>A load rated power</td>
</tr>
<tr>
<td style="text-align: left;">bvpv</td>
<td style="text-align: left;">string</td>
<td>Phase B voltage</td>
</tr>
<tr>
<td style="text-align: left;">atemp</td>
<td style="text-align: left;">string</td>
<td>A road temperature</td>
</tr>
<tr>
<td style="text-align: left;">v9420Status</td>
<td style="text-align: left;">string</td>
<td>V9420 working status</td>
</tr>
<tr>
<td style="text-align: left;">maxTemp</td>
<td style="text-align: left;">string</td>
<td>SCR temperature limit</td>
</tr>
<tr>
<td style="text-align: left;">cstartPower</td>
<td style="text-align: left;">string</td>
<td>C start power</td>
</tr>
<tr>
<td style="text-align: left;">waterHeaterPower</td>
<td style="text-align: left;">string</td>
<td>Water heater rated power</td>
</tr>
<tr>
<td style="text-align: left;">cvpv</td>
<td style="text-align: left;">string</td>
<td>C phase voltage</td>
</tr>
<tr>
<td style="text-align: left;">aonOff</td>
<td style="text-align: left;">int</td>
<td>A time switch</td>
</tr>
<tr>
<td style="text-align: left;">tempEnable</td>
<td style="text-align: left;">int</td>
<td>ABC temperature enable switch</td>
</tr>
<tr>
<td style="text-align: left;">dryContactOnOff</td>
<td style="text-align: left;">int</td>
<td>Dry contact time switch</td>
</tr>
<tr>
<td style="text-align: left;">bstartPower</td>
<td style="text-align: left;">string</td>
<td>B start power</td>
</tr>
<tr>
<td style="text-align: left;">jobsModel</td>
<td style="text-align: left;">int</td>
<td>shineBoost work mode</td>
</tr>
<tr>
<td style="text-align: left;">conOff</td>
<td style="text-align: left;">int</td>
<td>C time switch</td>
</tr>
<tr>
<td style="text-align: left;">ctemp</td>
<td style="text-align: left;">string</td>
<td>C road temperature</td>
</tr>
<tr>
<td style="text-align: left;">boost_sn</td>
<td style="text-align: left;">string</td>
<td>Serial number</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: Boost does not exist, 10003: device SN error, 10011: no permission</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>
-The frequency of acquisition is once every 10 seconds</p>