Query the monthly power generation of Inverters or other power generation Device for a certain year
for example: http://api.shinemonitor.com/public/?sign=45a0317337cad1b975b7cc8e6ae35401daa5c356&salt=6799118618252297881&token=5b13e18eaa179d4bdce4cf2cc0e66eaa506c7f27ccac6b9e7beaa190ec0e386f&action=queryDeviceEnergyYearPerMonth&pn=COLLECTOR0001&devcode=752&devaddr=1&sn=687484400018&date=2017&source=0&_app_client_=android&_app_id_=com.demo.test&_app_version_=3.6.2.1
| Parameter |
Description |
Required |
| action |
queryDeviceEnergyYearPerMonth |
True |
| pn |
Datalogger number |
True |
| devcode |
Device protocol encoding |
True |
| devaddr |
Device address (485 bus) |
True |
| sn |
Device serial number |
True |
| date |
Date to query, format: yyyy, Date is considered as the time zone where the Device is located, If this parameter is not passed, it will be defaulted to this year |
False |
response:
The interface always returns the power generation of each month throughout the year, and if this month has not yet arrived, it returns 0
| Parameter |
Description |
Required |
| permonth[x].val |
Electricity generation in a certain month of a year, Standardized units of electricity generation |
True |
| permonth[x].ts |
Month in a year, format: yyyy-mm-dd hh:mi:ss, dd is always the 1st of this month, and the hh: mi: ss part is meaningless |
True |
{
"err":0,
"desc":"ERR_NONE",
"dat":{
"permonth":[
{
"val":"0.00",
"ts":"2017-01-01 00:00:00"
},
{
"val":"0.01",
"ts":"2017-02-01 00:00:00"
}
]
}
}
Possible errors:
| Response error code |
Description |
Details |
| 0x0006 |
ERR_FORMAT_ERROR |
Parameter error |
| 0x000C |
ERR_NO_RECORD |
No records (no data reported by the Device was found) |
| 0x0102 |
ERR_NOT_FOUND_DEVICE |
Device not found |