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>{
&quot;data&quot;: {
&quot;count&quot;: 3,
&quot;devices&quot;: [
{
&quot;device_sn&quot;: &quot;ZT00100001&quot;,
&quot;last_update_time&quot;: &quot;2018-12-13 11:03:52&quot;,
&quot;model&quot;: &quot;A0B0D0T0PFU1M3S4&quot;,
&quot;lost&quot;: true,
&quot;status&quot;: 0,
&quot;manufacturer&quot;: &quot;Growatt&quot;,
&quot;device_id&quot;: 116,
&quot;datalogger_sn&quot;: &quot;CRAZT00001&quot;,
&quot;type&quot;: 1
},
{
&quot;device_sn&quot;: &quot;AMMETER&quot;,
&quot;last_update_time&quot;: &quot;2018-12-13 11:03:52&quot;,
&quot;model&quot;: &quot;&quot;,
&quot;manufacturer&quot;: &quot;Growatt&quot;,
&quot;device_id&quot;: &quot;&quot;,
&quot;datalogger_sn&quot;: &quot;CRAZT00001&quot;,
&quot;type&quot;: 3
},
{
&quot;device_sn&quot;: &quot;ENV_DEVICE&quot;,
&quot;last_update_time&quot;: &quot;2018-12-13 11:03:52&quot;,
&quot;model&quot;: &quot;&quot;,
&quot;manufacturer&quot;: &quot;Growatt&quot;,
&quot;device_id&quot;: &quot;&quot;,
&quot;datalogger_sn&quot;: &quot;CRAZT00001&quot;,
&quot;type&quot;: 3
}
]
},
&quot;error_code&quot;: 0,
&quot;error_msg&quot;: &quot;&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>