ShineServer_English version


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>

页面列表

ITEM_HTML