Document description
Interface documentation
Modification record
Global error code
Interface display
User correlation
Power station relate
Equipment related
Device type description
3.1 Add collector
3.2 Delete collector
3.3 Obtain a power station equipment list
3.4 Get a list of power station collectors
3.5 Query device type according to SN
3.6 Check whether the collector SN and check code
3.41 Obtaining the historical power generation of
3.43 Query collector based on SN
Get device creation dates in batches (from October
Add device associated account interface
Inverter
Energy storage machi
Max
SPH
spa
Min
Pcs
Hps
Pbd
Smart meter
Environmental tester
VPP
GroBoost

ShineServer_English version


3.3 Obtain a power station equipment list

<p><strong>A brief description:</strong> </p> <p>-Interface to get a list of power station equipment</p> <p><strong>Request URL:</strong> -<code>http(s)://test.growatt.com/v1/device/list</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;">plant_id</td> <td style="text-align: left;">Yes</td> <td style="text-align: left;">int</td> <td>plant ID</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 per page, default 20, maximum 100</td> </tr> </tbody> </table> <p><strong>Return example</strong></p> <pre><code>{ &amp;quot;data&amp;quot;: { &amp;quot;count&amp;quot;: 3, &amp;quot;devices&amp;quot;: [ { &amp;quot;device_sn&amp;quot;: &amp;quot;ZT00100001&amp;quot;, &amp;quot;last_update_time&amp;quot;: &amp;quot;2018-12-13 11:03:52&amp;quot;, &amp;quot;model&amp;quot;: &amp;quot;A0B0D0T0PFU1M3S4&amp;quot;, &amp;quot;lost&amp;quot;: true, &amp;quot;status&amp;quot;: 0, &amp;quot;manufacturer&amp;quot;: &amp;quot;Growatt&amp;quot;, &amp;quot;device_id&amp;quot;: 116, &amp;quot;datalogger_sn&amp;quot;: &amp;quot;CRAZT00001&amp;quot;, &amp;quot;type&amp;quot;: 1 }, { &amp;quot;device_sn&amp;quot;: &amp;quot;AMMETER&amp;quot;, &amp;quot;last_update_time&amp;quot;: &amp;quot;2018-12-13 11:03:52&amp;quot;, &amp;quot;model&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;manufacturer&amp;quot;: &amp;quot;Growatt&amp;quot;, &amp;quot;device_id&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;datalogger_sn&amp;quot;: &amp;quot;CRAZT00001&amp;quot;, &amp;quot;type&amp;quot;: 3 }, { &amp;quot;device_sn&amp;quot;: &amp;quot;ENV_DEVICE&amp;quot;, &amp;quot;last_update_time&amp;quot;: &amp;quot;2018-12-13 11:03:52&amp;quot;, &amp;quot;model&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;manufacturer&amp;quot;: &amp;quot;Growatt&amp;quot;, &amp;quot;device_id&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;datalogger_sn&amp;quot;: &amp;quot;CRAZT00001&amp;quot;, &amp;quot;type&amp;quot;: 3 } ] }, &amp;quot;error_code&amp;quot;: 0, &amp;quot;error_msg&amp;quot;: &amp;quot;&amp;quot; }</code></pre> <p><strong>Special Note:</strong> -<code>Device type:</code> <code>1: Inverter (zt Include including MAX)</code> <code>2: Energy storage machine</code> <code>3: Other equipment</code> <code>4: MAX (single MAX)</code> <code>5: sph</code> <code>6: SPA</code> <code>7: MIN</code> <code>8: PCS</code> <code>9: HPS</code> <code>10: PBD</code></p> <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 number of devices</td> </tr> <tr> <td style="text-align: left;">datalogger_sn</td> <td style="text-align: left;">string</td> <td>The collector SN corresponding to the device</td> </tr> <tr> <td style="text-align: left;">device_sn</td> <td style="text-align: left;">string</td> <td>Device SN</td> </tr> <tr> <td style="text-align: left;">manufacturer</td> <td style="text-align: left;">int</td> <td>Equipment manufacturer</td> </tr> <tr> <td style="text-align: left;">model</td> <td style="text-align: left;">stint</td> <td>device model</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">string</td> <td>Equipment type (1: inverter (including MAX), 2: energy storage machine, 3: other equipment, 4: MAX (single MAX), 5: SPH, 6: SPA, 7: MIN, 8 : PCS, 9: HPS, 10: PBD)</td> </tr> <tr> <td style="text-align: left;">last_update_time</td> <td style="text-align: left;">string</td> <td>Last data received time</td> </tr> <tr> <td style="text-align: left;">lost</td> <td style="text-align: left;">int</td> <td>whether the device is online or not (0: online, 1: disconnected)</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">string</td> <td>Device status, if the device is 1 (inverter), then status (0: disconnected, 1: online, 2: standby, 3; fault, all others are offline), if the device is 2 ( Energy storage machine), then status (0: standby, 1: charging, 2: discharging, 3: fault, 4: burning, others are offline), if the device is 4 (Max device), then status(0: Standby, 1: online, 2: standby, 3; failure, all others are offline); if the device is 6 (Spa) Status 0: waiting mode 1: self-check mode, 3: failure mode, 4: upgrading, 5 , 6, 7, 8: normal mode, all others are offline; if the device is 5 (Mix) Status 0: waiting mode, 1: self-check mode, 3: failure mode, 4: upgrading, 5, 6, 7 , 8: Normal mode, all others are offline; if the device is in 7 (MIN) state, status (0 disconnected, 1: online, 2: standby, 3; failure, all others are offline)</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: power station ID is empty, 10003: power station 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> <p>-The frequency of acquisition is once every 5 minutes</p>

页面列表

ITEM_HTML