ShineServer_English version


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>{     &amp;quot;data&amp;quot;: {         &amp;quot;plant&amp;quot;: {             &amp;quot;status&amp;quot;: 4,             &amp;quot;locale&amp;quot;: &amp;quot;&amp;quot;,             &amp;quot;total_energy&amp;quot;: 15.699999809265137,             &amp;quot;operator&amp;quot;: &amp;quot;API interface test vendor&amp;quot;,             &amp;quot;country&amp;quot;: &amp;quot;China&amp;quot;,             &amp;quot;city&amp;quot;: &amp;quot;Shenzhen&amp;quot;,             &amp;quot;current_power&amp;quot;: &amp;quot;&amp;quot;,             &amp;quot;create_date&amp;quot;: &amp;quot;2018-12-12&amp;quot;,             &amp;quot;image_url&amp;quot;: &amp;quot;2.png&amp;quot;,             &amp;quot;plant_id&amp;quot;: 24765,             &amp;quot;name&amp;quot;: &amp;quot;API interface test power station&amp;quot;,             &amp;quot;longitude&amp;quot;: &amp;quot;113.9&amp;quot;,             &amp;quot;user_id&amp;quot;: 33,             &amp;quot;installer&amp;quot;: &amp;quot;API interface test vendor&amp;quot;,             &amp;quot;latitude&amp;quot;: &amp;quot;22.6&amp;quot;,             &amp;quot;peak_power&amp;quot;: 20,             &amp;quot;latitude_d&amp;quot;: null,             &amp;quot;latitude_f&amp;quot;: null         }     },     &amp;quot;error_code&amp;quot;: 0,     &amp;quot;error_msg&amp;quot;: &amp;quot;&amp;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;">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>

页面列表

ITEM_HTML