Obtain historical data of an inverter
<p><strong>A brief description:</strong> </p>
<p>-Interface to obtain historical data of a certain inverter
-<code>Only applicable to devices with device type 1 returned in the 3.3 interface.</code></p>
<p><strong>Request URL:</strong>
-<code>http(s)://test.growatt.com/v1/device/inverter/data</code></p>
<p><strong>How to request:</strong>
-get</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;">device_sn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">string</td>
<td>device unique serial number (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 (start/end time can be separated by up to 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;">string</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 of pages, default 20, maximum 1000</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": [
{
"vac2": 220,
"vac3": 220,
"ipv3": 0,
"vac1": 220,
"ipv2": 0,
"ipv1": 0,
"power_factor": -1,
"total_energy": "7.6",
"temperature": 75,
"time": "2018-12-13 11:03:52",
"iac2": 12,
"iac1": 12,
"vpv1": 248,
"vpv3": 0,
"fac": 50,
"vpv2": 0,
"today_energy": "7.6",
"power": 8912.400390625,
"iac3": 12
}
],
"sn": "ZT00100001",
"next_page_start_id": 21,
"datalogger_sn": "CRAZT00001"
},
"error_code": 0,
"error_msg": ""
}</code></pre>
<p><strong>Return parameter description</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter name</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">datalogger_sn</td>
<td style="text-align: left;">int</td>
<td>The collector SN corresponding to the device</td>
</tr>
<tr>
<td style="text-align: left;">next_page_start_id</td>
<td style="text-align: left;">string</td>
<td>Next page start ID</td>
</tr>
<tr>
<td style="text-align: left;">sn</td>
<td style="text-align: left;">string</td>
<td>Device SN</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string</td>
<td>Device status (0: waiting, 1: normal, 3: failure)</td>
</tr>
<tr>
<td style="text-align: left;">ipv1</td>
<td style="text-align: left;">string</td>
<td>Input current 1 way (A)</td>
</tr>
<tr>
<td style="text-align: left;">ipv2</td>
<td style="text-align: left;">int</td>
<td>Input current 2 (A)</td>
</tr>
<tr>
<td style="text-align: left;">vpv1</td>
<td style="text-align: left;">int</td>
<td>Input voltage 1 way (V)</td>
</tr>
<tr>
<td style="text-align: left;">vpv2</td>
<td style="text-align: left;">string</td>
<td>Input voltage 2 channels (V)</td>
</tr>
<tr>
<td style="text-align: left;">iac1</td>
<td style="text-align: left;">string</td>
<td>Output current 1 way (A)</td>
</tr>
<tr>
<td style="text-align: left;">iac2</td>
<td style="text-align: left;">int</td>
<td>Output current 2 (A)</td>
</tr>
<tr>
<td style="text-align: left;">iac3</td>
<td style="text-align: left;">string</td>
<td>Output current 3 channels (A)</td>
</tr>
<tr>
<td style="text-align: left;">vac1</td>
<td style="text-align: left;">string</td>
<td>Output voltage 1 way (V)</td>
</tr>
<tr>
<td style="text-align: left;">vac2</td>
<td style="text-align: left;">string</td>
<td>Output voltage 2 channels (V)</td>
</tr>
<tr>
<td style="text-align: left;">vac3</td>
<td style="text-align: left;">int</td>
<td>Output voltage 3 (V)</td>
</tr>
<tr>
<td style="text-align: left;">power</td>
<td style="text-align: left;">int</td>
<td>Output power (W)</td>
</tr>
<tr>
<td style="text-align: left;">today_energy</td>
<td style="text-align: left;">string</td>
<td>Today's power generation (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">total_energy</td>
<td style="text-align: left;">string</td>
<td>Total power generation (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;">fac</td>
<td style="text-align: left;">string</td>
<td>Frequency (Hz)</td>
</tr>
<tr>
<td style="text-align: left;">power_factor</td>
<td style="text-align: left;">string</td>
<td>Power factor</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;">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</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 5 minutes</p>