ShineServer_English version


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>

页面列表

ITEM_HTML