3.4 Get a list of power station collectors
<p><strong>A brief description:</strong> </p>
<p>-The interface to obtain the collector list of a certain power station</p>
<p><strong>Request URL:</strong>
-<code>http(s)://test.growatt.com/v1/device/datalogger/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;peak_power_actual&quot;: {
&quot;treeID&quot;: &quot;PLANT_24765&quot;,
&quot;flatPeriodPrice&quot;: 0,
&quot;longitudeText&quot;: &quot;null°null′null″&quot;,
&quot;storage_eChargeToday&quot;: 0,
&quot;storage_BattoryPercentage&quot;: 0,
&quot;dataLogList&quot;: [],
&quot;designCompany&quot;: &quot;API interface testing manufacturer&quot;,
&quot;timezoneText&quot;: &quot;GMT+8&quot;,
&quot;defaultPlant&quot;: false,
&quot;peakPeriodPrice&quot;: 0,
&quot;formulaCoal&quot;: 0.4000000059604645,
&quot;storage_eDisChargeToday&quot;: 0,
&quot;city&quot;: &quot;Shenzhen&quot;,
&quot;nominalPower&quot;: 20000,
&quot;unitMap&quot;: null,
&quot;timezone&quot;: 8,
&quot;level&quot;: 1,
&quot;formulaMoneyUnitId&quot;: &quot;rmb&quot;,
&quot;currentPacTxt&quot;: &quot;0&quot;,
&quot;panelTemp&quot;: 0,
&quot;fixedPowerPrice&quot;: 0,
&quot;imgPath&quot;: &quot;css/img/plant.gif&quot;,
&quot;storage_TotalToGrid&quot;: 0,
&quot;moneyUnitText&quot;: &quot;￥&quot;,
&quot;locationImgName&quot;: &quot;1.png&quot;,
&quot;prToday&quot;: &quot;0&quot;,
&quot;energyMonth&quot;: 0,
&quot;deviceCount&quot;: 0,
&quot;plantName&quot;: &quot;API interface test plant&quot;,
&quot;plantImgName&quot;: &quot;2.png&quot;,
&quot;eToday&quot;: 0,
&quot;etodaySo2Text&quot;: &quot;0&quot;,
&quot;country&quot;: &quot;China&quot;,
&quot;emonthMoneyText&quot;: &quot;0&quot;,
&quot;longitude_d&quot;: &quot;&quot;,
&quot;longitude_f&quot;: &quot;&quot;,
&quot;formulaMoney&quot;: 1.2000000476837158,
&quot;userAccount&quot;: &quot;API interface test&quot;,
&quot;mapLat&quot;: &quot;&quot;,
&quot;longitude_m&quot;: &quot;&quot;,
&quot;createDateText&quot;: &quot;2018-12-12&quot;,
&quot;formulaSo2&quot;: 0.800000011920929,
&quot;valleyPeriodPrice&quot;: 0,
&quot;mapLng&quot;: &quot;&quot;,
&quot;energyYear&quot;: 0,
&quot;treeName&quot;: &quot;API interface test power station&quot;,
&quot;plant_lat&quot;: &quot;22.6&quot;,
&quot;onLineEnvCount&quot;: 0,
&quot;etodayCo2Text&quot;: &quot;0&quot;,
&quot;latitudeText&quot;: &quot;null°null′null″&quot;,
&quot;etotalSo2Text&quot;: &quot;0&quot;,
&quot;children&quot;: [],
&quot;hasDeviceOnLine&quot;: 0,
&quot;id&quot;: 24765,
&quot;etodayCoalText&quot;: &quot;0&quot;,
&quot;etodayMoney&quot;: 0,
&quot;createDate&quot;: {
&quot;time&quot;: 1544544000000,
&quot;minutes&quot;: 0,
&quot;seconds&quot;: 0,
&quot;hours&quot;: 0,
&quot;month&quot;: 11,
&quot;year&quot;: 118,
&quot;timezoneOffset&quot;: -480,
&quot;day&quot;: 3,
&quot;date&quot;: 12
},
&quot;prMonth&quot;: &quot;0&quot;,
&quot;mapCity&quot;: &quot;&quot;,
&quot;etotalMoney&quot;: 0,
&quot;envTemp&quot;: 0,
&quot;storage_TodayToGrid&quot;: 0,
&quot;alias&quot;: &quot;&quot;,
&quot;etotalCo2Text&quot;: &quot;0&quot;,
&quot;emonthCo2Text&quot;: &quot;0&quot;,
&quot;eTotal&quot;: 0,
&quot;etotalMoneyText&quot;: &quot;0&quot;,
&quot;formulaCo2&quot;: 0.6000000238418579,
&quot;irradiance&quot;: 0,
&quot;emonthSo2Text&quot;: &quot;0&quot;,
&quot;hasStorage&quot;: 0,
&quot;windAngle&quot;: 0,
&quot;etotalCoalText&quot;: &quot;0&quot;,
&quot;windSpeed&quot;: 0,
&quot;emonthCoalText&quot;: &quot;0&quot;,
&quot;parentID&quot;: &quot;&quot;,
&quot;EYearMoneyText&quot;: &quot;0&quot;,
&quot;etodayMoneyText&quot;: &quot;0&quot;,
&quot;plant_lng&quot;: &quot;113.9&quot;,
&quot;pairViewUserAccount&quot;: &quot;&quot;,
&quot;latitude_m&quot;: &quot;&quot;,
&quot;userBean&quot;: null,
&quot;storage_TotalToUser&quot;: 0,
&quot;storage_TodayToUser&quot;: 0,
&quot;isShare&quot;: false,
&quot;currentPac&quot;: 0,
&quot;latitude_d&quot;: &quot;&quot;,
&quot;latitude_f&quot;: &quot;&quot;
},
&quot;count&quot;: 1,
&quot;dataloggers&quot;: [
{
&quot;last_update_time&quot;: {
&quot;time&quot;: 1544670394000,
&quot;minutes&quot;: 6,
&quot;seconds&quot;: 34,
&quot;hours&quot;: 11,
&quot;month&quot;: 11,
&quot;timezoneOffset&quot;: -480,
&quot;year&quot;: 118,
&quot;day&quot;: 4,
&quot;date&quot;: 13
},
&quot;model&quot;: &quot;ShineWifiBox&quot;,
&quot;sn&quot;: &quot;CRAZT00001&quot;,
&quot;lost&quot;: true,
&quot;manufacturer&quot;: &quot;Growatt&quot;,
&quot;type&quot;: 0
}
]
},
&quot;error_code&quot;: 0,
&quot;error_msg&quot;: &quot;&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;">count</td>
<td style="text-align: left;">int</td>
<td>Total number of collectors</td>
</tr>
<tr>
<td style="text-align: left;">sn</td>
<td style="text-align: left;">string</td>
<td>Collector SN</td>
</tr>
<tr>
<td style="text-align: left;">manufacturer</td>
<td style="text-align: left;">string</td>
<td>collector manufacturer</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">string</td>
<td>Collector type</td>
</tr>
<tr>
<td style="text-align: left;">last_update_time</td>
<td style="text-align: left;">time</td>
<td>Last data received time</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;">netmode</td>
<td style="text-align: left;">string</td>
<td>0：none; 1:weifi; 2:4G; 3:LAN</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>