for example: http://api.shinemonitor.com/public/?sign=45a0317337cad1b975b7cc8e6ae35401daa5c356&salt=6799118618252297881&token=5b13e18eaa179d4bdce4cf2cc0e66eaa506c7f27ccac6b9e7beaa190ec0e386f&action=queryDeviceDataOneDayPaging&i18n=zh_CN&pn=J1817101731142&devcode=752&devaddr=1&sn=687484400018&date=2017-04-05&page=0&pagesize=10&source=0&_app_client_=android&_app_id_=com.demo.test&_app_version_=3.6.2.1
Parameter |
Description |
Required |
action |
queryDeviceDataOneDayPaging |
True |
i18n |
Internationalized language, refer to Multi-Language Support |
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-mm-dd, Date is considered as the time zone where the Device is located, If this parameter is not passed, it will be defaulted to today |
False |
page |
Paging processing, page number, starting from 0. If this parameter is not passed, it is defaulted to 0 |
False |
pagesize |
Paging processing, with 1 to 50 records per page. If this parameter is not passed, it defaults to 1 |
False |
response:
Parameter |
Description |
Required |
total |
Total number of data records for the day |
True |
page |
Paging processing, which page |
True |
pagesize |
Paging processing, number of records per page |
True |
title[x].title |
Name of the device protocol field |
True |
title[x].unit |
The unit of the device protocol field. Some fields have units, such as the power output unit W of the Inverter, while others may not have units, such as the serial number |
False |
row[x].realtime |
Is this data real-time? True represents real-time data, and false represents historical data |
True |
row[x].filed[y] |
The value of the device protocol field, title. size() is always equal to row [x]. file. size(), and they correspond one-to-one |
True |
In particular, it should be noted that row [x]. filed [0], row [x]. filed [1] always represents the unique identifier of the current data row and the timestamp of the time when the data occurred (in the device's time zone). The timestamp format is yyyy mm dd hh: mi: ss
.
{
"err":0,
"desc":"ERR_NONE",
"dat":{
"total":8,
"page":0,
"pagesize":1,
"title":[
{
"title":"id"
},
{
"title":"时间戳"
},
{
"title":"序列号"
},
{
"title":"PV1输入电压",
"unit":"V"
},
{
"title":"PV2输入电压",
"unit":"V"
},
{
"title":"PV3输入电压",
"unit":"V"
},
{
"title":"PV1输入电流",
"unit":"A"
},
{
"title":"PV2输入电流",
"unit":"A"
},
{
"title":"PV3输入电流",
"unit":"A"
},
{
"title":"PV1输入功率",
"unit":"W"
},
{
"title":"PV2输入功率",
"unit":"W"
},
{
"title":"PV3输入功率",
"unit":"W"
},
{
"title":"R相电网电压",
"unit":"V"
},
{
"title":"S相电网电压",
"unit":"V"
},
{
"title":"T相电网电压",
"unit":"V"
},
{
"title":"并网功率",
"unit":"W"
},
{
"title":"散热器温度",
"unit":"°C"
},
{
"title":"模块温度",
"unit":"°C"
},
{
"title":"逆变器工作模式"
},
{
"title":"运行时间",
"unit":"Hour"
},
{
"title":"发电时间",
"unit":"Hour"
},
{
"title":"并网次数"
},
{
"title":"总发电量",
"unit":"kWh"
},
{
"title":"启动后功率峰值",
"unit":"W"
},
{
"title":"当天功率峰值",
"unit":"W"
}
],
"row":[
{
"realtime":true
"field":[
"bcaa940319ac11e7bde91c6f6593e938",
"2017-04-05 11:06:40",
"687484400018",
"608.4",
"582.9",
"9.8",
"1.76",
"1.56",
"0.07",
"1071",
"914",
"0",
"233.1",
"240.3",
"225.5",
"1977",
"29.6",
"37.4",
"正常",
"120",
"116",
"000067",
"336",
"8668",
"3995"
]
},
Object{...},
Object{...},
Object{...}
]
}
}
Possible errors:
Response error code |
Description |
Details |
0x0006 |
ERR_FORMAT_ERROR |
Parameter error |
0x000C |
ERR_NO_RECORD |
No record (the Device has no data) |
0x0102 |
ERR_NOT_FOUND_DEVICE |
Device not found |