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>{
"data": {
"peak_power_actual": {
"treeID": "PLANT_24765",
"flatPeriodPrice": 0,
"longitudeText": "null°null′null″",
"storage_eChargeToday": 0,
"storage_BattoryPercentage": 0,
"dataLogList": [],
"designCompany": "API interface testing manufacturer",
"timezoneText": "GMT+8",
"defaultPlant": false,
"peakPeriodPrice": 0,
"formulaCoal": 0.4000000059604645,
"storage_eDisChargeToday": 0,
"city": "Shenzhen",
"nominalPower": 20000,
"unitMap": null,
"timezone": 8,
"level": 1,
"formulaMoneyUnitId": "rmb",
"currentPacTxt": "0",
"panelTemp": 0,
"fixedPowerPrice": 0,
"imgPath": "css/img/plant.gif",
"storage_TotalToGrid": 0,
"moneyUnitText": "￥",
"locationImgName": "1.png",
"prToday": "0",
"energyMonth": 0,
"deviceCount": 0,
"plantName": "API interface test plant",
"plantImgName": "2.png",
"eToday": 0,
"etodaySo2Text": "0",
"country": "China",
"emonthMoneyText": "0",
"longitude_d": "",
"longitude_f": "",
"formulaMoney": 1.2000000476837158,
"userAccount": "API interface test",
"mapLat": "",
"longitude_m": "",
"createDateText": "2018-12-12",
"formulaSo2": 0.800000011920929,
"valleyPeriodPrice": 0,
"mapLng": "",
"energyYear": 0,
"treeName": "API interface test power station",
"plant_lat": "22.6",
"onLineEnvCount": 0,
"etodayCo2Text": "0",
"latitudeText": "null°null′null″",
"etotalSo2Text": "0",
"children": [],
"hasDeviceOnLine": 0,
"id": 24765,
"etodayCoalText": "0",
"etodayMoney": 0,
"createDate": {
"time": 1544544000000,
"minutes": 0,
"seconds": 0,
"hours": 0,
"month": 11,
"year": 118,
"timezoneOffset": -480,
"day": 3,
"date": 12
},
"prMonth": "0",
"mapCity": "",
"etotalMoney": 0,
"envTemp": 0,
"storage_TodayToGrid": 0,
"alias": "",
"etotalCo2Text": "0",
"emonthCo2Text": "0",
"eTotal": 0,
"etotalMoneyText": "0",
"formulaCo2": 0.6000000238418579,
"irradiance": 0,
"emonthSo2Text": "0",
"hasStorage": 0,
"windAngle": 0,
"etotalCoalText": "0",
"windSpeed": 0,
"emonthCoalText": "0",
"parentID": "",
"EYearMoneyText": "0",
"etodayMoneyText": "0",
"plant_lng": "113.9",
"pairViewUserAccount": "",
"latitude_m": "",
"userBean": null,
"storage_TotalToUser": 0,
"storage_TodayToUser": 0,
"isShare": false,
"currentPac": 0,
"latitude_d": "",
"latitude_f": ""
},
"count": 1,
"dataloggers": [
{
"last_update_time": {
"time": 1544670394000,
"minutes": 6,
"seconds": 34,
"hours": 11,
"month": 11,
"timezoneOffset": -480,
"year": 118,
"day": 4,
"date": 13
},
"model": "ShineWifiBox",
"sn": "CRAZT00001",
"lost": true,
"manufacturer": "Growatt",
"type": 0
}
]
},
"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;">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>