2.8Historical power generation of the power statio
<p><strong>A brief description:</strong> </p>
<ul>
<li>Obtain an interface for historical power generation of a power station</li>
</ul>
<p><strong>Request URL: </strong></p>
<ul>
<li><code>http(s)://test.growatt.com/v1/plant/energy</code>
<strong>Request method: </strong></li>
<li>get</li>
</ul>
<p><strong>Parameters: </strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter Name</th>
<th style="text-align: left;">Whether Required</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">plant_id</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">int</td>
<td>Power Station ID</td>
</tr>
<tr>
<td style="text-align: left;">start_date</td>
<td style="text-align: left;">Yes</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(date interval cannot exceed 7 days)</td>
</tr>
<tr>
<td style="text-align: left;">time_unit</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">string</td>
<td>time type:"day" or "month" or "year"</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>page number,default 1</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, max 100</td>
</tr>
</tbody>
</table>
<p> <strong>Back to example</strong></p>
<pre><code>{
&quot;data&quot;: {
&quot;count&quot;: 6,
&quot;time_unit&quot;: &quot;day&quot;,
&quot;energys&quot;: [
{
&quot;date&quot;: &quot;2018-12-12&quot;,
&quot;energy&quot;: &quot;0&quot;
},
{
&quot;date&quot;: &quot;2018-12-13&quot;,
&quot;energy&quot;: &quot;7.6&quot;
},
{
&quot;date&quot;: &quot;2018-12-14&quot;,
&quot;energy&quot;: &quot;0&quot;
},
{
&quot;date&quot;: &quot;2018-12-15&quot;,
&quot;energy&quot;: &quot;0&quot;
},
{
&quot;date&quot;: &quot;2018-12-16&quot;,
&quot;energy&quot;: &quot;0&quot;
},
{
&quot;date&quot;: &quot;2018-12-17&quot;,
&quot;energy&quot;: &quot;0&quot;
}
]
},
&quot;error_code&quot;: 0,
&quot;error_msg&quot;: &quot;&quot;
}</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;">count</td>
<td style="text-align: left;">int</td>
<td>Total Records</td>
</tr>
<tr>
<td style="text-align: left;">time_unit</td>
<td style="text-align: left;">string</td>
<td>time_unit on request</td>
</tr>
<tr>
<td style="text-align: left;">date</td>
<td style="text-align: left;">string</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">energy</td>
<td style="text-align: left;">string</td>
<td>Power Generation (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">int</td>
<td>0: Normal return, 10001: System error, 10002: Power station does not exist, 10003: Power station ID is empty, 10004: Time format is incorrect</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>
<ul>
<li>Get the frequency once every 5 minutes</li>
<li>This interface is only allowed to call 10 times a day</li>
</ul>