2.10 Get the plant information of a device
<p><strong>A brief description:</strong> </p>
<ul>
<li>Obtain an interface for the plant information of a device</li>
</ul>
<p><strong>Request URL: </strong></p>
<ul>
<li><code>http(s)://test.growatt.com/v1/plant/sn_plant</code>
<strong>Request method: </strong></li>
<li>post</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;">device_sn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">string</td>
<td>Device serial number (non-collector serial number)</td>
</tr>
</tbody>
</table>
<p> <strong>Back to example</strong></p>
<pre><code>{
"data": {
"plant": {
"status": 4,
"locale": "",
"total_energy": 15.699999809265137,
"operator": "API interface test vendor",
"country": "China",
"city": "Shenzhen",
"current_power": "",
"create_date": "2018-12-12",
"image_url": "2.png",
"plant_id": 24765,
"name": "API interface test power station",
"longitude": "113.9",
"user_id": 33,
"installer": "API interface test vendor",
"latitude": "22.6",
"peak_power": 20,
"latitude_d": null,
"latitude_f": null
}
},
"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;">plant_id</td>
<td style="text-align: left;">int</td>
<td>Power Station ID</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td>Power Station Name</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">int</td>
<td>User ID to which the plant belongs</td>
</tr>
<tr>
<td style="text-align: left;">country</td>
<td style="text-align: left;">string</td>
<td>country name</td>
</tr>
<tr>
<td style="text-align: left;">longitude</td>
<td style="text-align: left;">string</td>
<td>Longitude</td>
</tr>
<tr>
<td style="text-align: left;">latitude</td>
<td style="text-align: left;">string</td>
<td>Latitude</td>
</tr>
<tr>
<td style="text-align: left;">peak_power</td>
<td style="text-align: left;">string</td>
<td>peak power (kWp)</td>
</tr>
<tr>
<td style="text-align: left;">create_date</td>
<td style="text-align: left;">string</td>
<td>Building Date</td>
</tr>
<tr>
<td style="text-align: left;">installer</td>
<td style="text-align: left;">string</td>
<td>installer name</td>
</tr>
<tr>
<td style="text-align: left;">total_energy</td>
<td style="text-align: left;">string</td>
<td>Cumulative power generation (kWh)</td>
</tr>
<tr>
<td style="text-align: left;">count</td>
<td style="text-align: left;">int</td>
<td>Total power stations</td>
</tr>
<tr>
<td style="text-align: left;">latitude_d</td>
<td style="text-align: left;">string</td>
<td>Agent Name</td>
</tr>
<tr>
<td style="text-align: left;">latitude_f</td>
<td style="text-align: left;">string</td>
<td>Agent Area</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: Account does not exist, 10003: Device serial number is empty, 10004: Device type is empty, 10005: Device 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>
<ul>
<li>Get the frequency once every 5 minutes</li>
</ul>