查询逆变器或其它发电设备某年每月的发电量
例, 请求: 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
| 参数 |
描述 |
必选 |
| action |
queryDeviceEnergyYearPerMonth |
是 |
| pn |
数采器编号 |
是 |
| devcode |
设备协议编码 |
是 |
| devaddr |
设备地址(485总线) |
是 |
| sn |
设备序列号 |
是 |
| date |
要查询的日期, 格式: yyyy, 日期被认为是设备所在时区, 如果不传递此参数, 则被默认为今年 |
否 |
响应:
接口总是会返回整年中每个月的发电量, 如果这个月还未到来, 则返回0.
| 参数 |
描述 |
必选 |
| permonth[x].val |
某年中某月的发电量, 发电量标准化单位 |
是 |
| permonth[x].ts |
某年中的每月, 格式为: yyyy-mm-dd hh:mi:ss, 其中dd总是这个月的1号, hh:mi:ss部分无意义 |
是 |
{
"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"
}
]
}
}
可能出现的错误:
| 返回错误码 |
描述 |
详细描述 |
| 0x0006 |
ERR_FORMAT_ERROR |
参数错误 |
| 0x000C |
ERR_NO_RECORD |
无记录(没有查询到设备上报的数据) |
| 0x0102 |
ERR_NOT_FOUND_DEVICE |
找不到设备 |