New API


Noah Device Historical Data

<p><strong>Brief Description:</strong></p> <ul> <li>Data format and parameter description of noah device historical data</li> <li><code>Only applicable: for retrieving all detailed data of a specific device on a particular day.</code></li> </ul> <p><strong>Return Example</strong></p> <pre><code>{     &amp;quot;code&amp;quot;: 0,     &amp;quot;data&amp;quot;: {         &amp;quot;endDate&amp;quot;: &amp;quot;2024-05-28&amp;quot;,         &amp;quot;datas&amp;quot;: [             {                 &amp;quot;serialNum&amp;quot;: &amp;quot;AGP0N1600D&amp;quot;,                 &amp;quot;dataLogSn&amp;quot;: null,                 &amp;quot;calendar&amp;quot;: 1716963973000,                 &amp;quot;withTime&amp;quot;: false,                 &amp;quot;status&amp;quot;: 6,                 &amp;quot;lost&amp;quot;: true,                 &amp;quot;ppv&amp;quot;: 3855.0,                 &amp;quot;ppv1&amp;quot;: 0.0,                 &amp;quot;ppv2&amp;quot;: 0.0,                 &amp;quot;ppv3&amp;quot;: 0.0,                 &amp;quot;vpv1&amp;quot;: 0.0,                 &amp;quot;vpv2&amp;quot;: 0.0,                 &amp;quot;vpv3&amp;quot;: 0.0,                 &amp;quot;ipv1&amp;quot;: 0.0,                 &amp;quot;ipv2&amp;quot;: 0.0,                 &amp;quot;ipv3&amp;quot;: 0.0,                 &amp;quot;pac&amp;quot;: 0.0,                 &amp;quot;fac&amp;quot;: 0.0,                 &amp;quot;vac1&amp;quot;: 0.0,                 &amp;quot;iac1&amp;quot;: 0.0,                 &amp;quot;pac1&amp;quot;: 0.0,                 &amp;quot;vac2&amp;quot;: 0.0,                 &amp;quot;iac2&amp;quot;: 0.0,                 &amp;quot;pac2&amp;quot;: 0.0,                 &amp;quot;eacToday&amp;quot;: 52.9,                 &amp;quot;eacTotal&amp;quot;: 10473.0,                 &amp;quot;timeTotal&amp;quot;: 0.0,                 &amp;quot;epv1Today&amp;quot;: 18.5,                 &amp;quot;epv1Total&amp;quot;: 0.0,                 &amp;quot;epv2Today&amp;quot;: 18.4,                 &amp;quot;epv2Total&amp;quot;: 0.0,                 &amp;quot;epv3Today&amp;quot;: 18.5,                 &amp;quot;epv3Total&amp;quot;: 0.0,                 &amp;quot;epvToday&amp;quot;: 55.4,                 &amp;quot;epvTotal&amp;quot;: 10758.6,                 &amp;quot;pf&amp;quot;: 0.0,                 &amp;quot;faultCode&amp;quot;: 0,                 &amp;quot;faultBitCode&amp;quot;: 0,                 &amp;quot;systemFault&amp;quot;: 0,                 &amp;quot;systemWarn&amp;quot;: 0,                 &amp;quot;warnCode1&amp;quot;: 0,                 &amp;quot;warnCode&amp;quot;: 0,                 &amp;quot;priorityChoose&amp;quot;: 0,                 &amp;quot;deviceType&amp;quot;: 0,                 &amp;quot;uwSysWorkMode&amp;quot;: 0,                 &amp;quot;sysFaultWord&amp;quot;: 0,                 &amp;quot;sysFaultWord1&amp;quot;: 0,                 &amp;quot;sysFaultWord2&amp;quot;: 0,                 &amp;quot;sysFaultWord3&amp;quot;: 0,                 &amp;quot;sysFaultWord4&amp;quot;: 0,                 &amp;quot;sysFaultWord5&amp;quot;: 0,                 &amp;quot;sysFaultWord6&amp;quot;: 0,                 &amp;quot;sysFaultWord7&amp;quot;: 0,                 &amp;quot;pdischarge1&amp;quot;: 0.0,                 &amp;quot;pcharge1&amp;quot;: 0.0,                 &amp;quot;vbat&amp;quot;: 53.2,                 &amp;quot;soc&amp;quot;: 99,                 &amp;quot;pacToUserR&amp;quot;: 0.0,                 &amp;quot;pacToUserTotal&amp;quot;: 0.0,                 &amp;quot;pacToGridR&amp;quot;: 0.0,                 &amp;quot;pacToGridS&amp;quot;: 0.0,                 &amp;quot;pacToGridTotal&amp;quot;: 0.0,                 &amp;quot;plocalLoadR&amp;quot;: 0.0,                 &amp;quot;plocalLoadS&amp;quot;: 0.0,                 &amp;quot;plocalLoadTotal&amp;quot;: 3734.0,                 &amp;quot;spStatus&amp;quot;: 0,                 &amp;quot;etoUserToday&amp;quot;: 0.0,                 &amp;quot;etoUserTotal&amp;quot;: 0.0,                 &amp;quot;etoGridToday&amp;quot;: 51.4,                 &amp;quot;etoGridTotal&amp;quot;: 10412.9,                 &amp;quot;edischarge1Today&amp;quot;: 0.0,                 &amp;quot;edischarge1Total&amp;quot;: 118.1,                 &amp;quot;echarge1Today&amp;quot;: 0.7,                 &amp;quot;echarge1Total&amp;quot;: 178.3,                 &amp;quot;elocalLoadToday&amp;quot;: 3.3,                 &amp;quot;elocalLoadTotal&amp;quot;: 285.5,                 &amp;quot;upsFac&amp;quot;: 50.0,                 &amp;quot;upsVac1&amp;quot;: 236.39999389648438,                 &amp;quot;epsIac1&amp;quot;: 0.0,                 &amp;quot;upsPac1&amp;quot;: 3734.0,                 &amp;quot;epsVac2&amp;quot;: 0.0,                 &amp;quot;epsIac2&amp;quot;: 0.0,                 &amp;quot;upsPac2&amp;quot;: 0.0,                 &amp;quot;bmsSOC&amp;quot;: 0,                 &amp;quot;bmsBatteryVolt&amp;quot;: 0.0,                 &amp;quot;bmsBatteryCurr&amp;quot;: 0.0,                 &amp;quot;bmsBatteryTemp&amp;quot;: 0.0,                 &amp;quot;bmsSOH&amp;quot;: 0,                 &amp;quot;bmsConstantVolt&amp;quot;: 0.0,                 &amp;quot;bmsUsingCap&amp;quot;: 0,                 &amp;quot;pex&amp;quot;: 3738.0,                 &amp;quot;esystemtoday&amp;quot;: 55.400001525878906,                 &amp;quot;esystemtotal&amp;quot;: 10876.7001953125,                 &amp;quot;eselftoday&amp;quot;: 4.0,                 &amp;quot;eselftotal&amp;quot;: 463.79998779296875,                 &amp;quot;psystem&amp;quot;: 3855.0,                 &amp;quot;pself&amp;quot;: 3855.0,                 &amp;quot;sysStatus&amp;quot;: 3,                 &amp;quot;dcTemp&amp;quot;: 0.0,                 &amp;quot;invTemp&amp;quot;: 0.0,                 &amp;quot;gridStatus&amp;quot;: 0,                 &amp;quot;genPower&amp;quot;: 0.0,                 &amp;quot;genVol&amp;quot;: 0.0,                 &amp;quot;genCurr&amp;quot;: 0.0,                 &amp;quot;genFreq&amp;quot;: 0.0,                 &amp;quot;genEnergy&amp;quot;: 0.0,                 &amp;quot;rLocalEnergy&amp;quot;: 0.0,                 &amp;quot;sLocalEnergy&amp;quot;: 0.0,                 &amp;quot;chipType&amp;quot;: 0,                 &amp;quot;genEnergyToday&amp;quot;: 0.0,                 &amp;quot;loadPower1&amp;quot;: 3714.0,                 &amp;quot;loadPower2&amp;quot;: 0.0,                 &amp;quot;rLoadVol&amp;quot;: 0.0,                 &amp;quot;sLoadVol&amp;quot;: 0.0,                 &amp;quot;esystemHour&amp;quot;: 1.6,                 &amp;quot;esystemMonth&amp;quot;: 1943.5,                 &amp;quot;esystemYear&amp;quot;: 10876.7,                 &amp;quot;eselfHour&amp;quot;: 0.1,                 &amp;quot;eselfMonth&amp;quot;: 151.8,                 &amp;quot;eselfYear&amp;quot;: 463.8,                 &amp;quot;eToGridHour&amp;quot;: 1.5,                 &amp;quot;eToGridMonth&amp;quot;: 1791.7,                 &amp;quot;eToGridYear&amp;quot;: 10412.9,                 &amp;quot;eToUserHour&amp;quot;: 0.0,                 &amp;quot;eToUserMonth&amp;quot;: 0.0,                 &amp;quot;eToUserYear&amp;quot;: 0.0,                 &amp;quot;elocalLoadHour&amp;quot;: 0.1,                 &amp;quot;elocalLoadMonth&amp;quot;: 151.8,                 &amp;quot;elocalLoadYear&amp;quot;: 0.0,                 &amp;quot;epvHour&amp;quot;: 1.6,                 &amp;quot;epvMonth&amp;quot;: 1903.2,                 &amp;quot;epvYear&amp;quot;: 10758.6,                 &amp;quot;batPower&amp;quot;: 0.0,                 &amp;quot;vbat1&amp;quot;: 0.0,                 &amp;quot;ibat&amp;quot;: 0.0,                 &amp;quot;m1Version&amp;quot;: &amp;quot;SK129.00-03141&amp;quot;,                 &amp;quot;m2Version&amp;quot;: &amp;quot;SK130.00-03131&amp;quot;,                 &amp;quot;hmiVersion&amp;quot;: &amp;quot;SK131.01-04301&amp;quot;,                 &amp;quot;sphBean&amp;quot;: null,                 &amp;quot;dayMap&amp;quot;: null,                 &amp;quot;again&amp;quot;: false,                 &amp;quot;statusText&amp;quot;: &amp;quot;Fault&amp;quot;,                 &amp;quot;errorText&amp;quot;: &amp;quot;Unknown&amp;quot;,                 &amp;quot;warnText&amp;quot;: &amp;quot;Unknown&amp;quot;,                 &amp;quot;ppvText&amp;quot;: &amp;quot;3855.0 W&amp;quot;,                 &amp;quot;socText&amp;quot;: &amp;quot;99%&amp;quot;,                 &amp;quot;time&amp;quot;: &amp;quot;2024-05-29 14:26:13&amp;quot;             }, ],         &amp;quot;start&amp;quot;: 0,         &amp;quot;haveNext&amp;quot;: false     },     &amp;quot;message&amp;quot;: &amp;quot;SUCCESSFUL_OPERATION&amp;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 style="text-align: left;">Description</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">deviceSn</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Device number</td> </tr> <tr> <td style="text-align: left;">datalogSn</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Data logger serial number</td> </tr> <tr> <td style="text-align: left;">time</td> <td style="text-align: left;">Date</td> <td style="text-align: left;">Time</td> </tr> <tr> <td style="text-align: left;">isAgain</td> <td style="text-align: left;">Boolean</td> <td style="text-align: left;">Is it retransmitted data</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">1: Normal, 4: Fault, 5: Heating</td> </tr> <tr> <td style="text-align: left;">mpptProtectStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">BIT0: PV1 overvoltage protection, BIT1: PV1 overcurrent protection, BIT2: PV1 overtemperature protection, BIT3: Reserved, BIT4: PV2 overvoltage protection, BIT5: PV2 overcurrent protection</td> </tr> <tr> <td style="text-align: left;">pdWarnStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">BIT0: Communication with BMS failed, BIT1: Communication with MPPT failed</td> </tr> <tr> <td style="text-align: left;">pac</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">BUCK output power</td> </tr> <tr> <td style="text-align: left;">eacToday</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Daily generated power</td> </tr> <tr> <td style="text-align: left;">eacMonth</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Monthly generated power</td> </tr> <tr> <td style="text-align: left;">eacYear</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Yearly generated power</td> </tr> <tr> <td style="text-align: left;">eacTotal</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Total generated power</td> </tr> <tr> <td style="text-align: left;">ppv</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Photovoltaic power (W)</td> </tr> <tr> <td style="text-align: left;">workMode</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Current time period work mode</td> </tr> <tr> <td style="text-align: left;">totalBatteryPackChargingStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">BIT0: Charging, BIT1: Discharging, if neither is present, standby is displayed</td> </tr> <tr> <td style="text-align: left;">totalBatteryPackChargingPower</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Total battery charging/discharging power</td> </tr> <tr> <td style="text-align: left;">batteryPackageQuantity</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Number of battery packs in parallel</td> </tr> <tr> <td style="text-align: left;">totalBatteryPackSoc</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Total battery pack SOC (State of Charge) as a percentage of battery capacity</td> </tr> <tr> <td style="text-align: left;">heatingStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Heating status BIT0: Battery 1 is heating, BIT1: Battery 2 is heating, BIT2: Battery 3 is heating, BIT3: Battery 4 is heating</td> </tr> <tr> <td style="text-align: left;">faultStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Fault status BIT0: Battery 1 fault, BIT1: Battery 2 fault, BIT2: Battery 3 fault, BIT3: Battery 4 fault</td> </tr> <tr> <td style="text-align: left;">battery1SerialNum</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Battery pack 1 - SN</td> </tr> <tr> <td style="text-align: left;">battery1Soc</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 1 - SOC</td> </tr> <tr> <td style="text-align: left;">battery1Temp</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Battery pack 1 - Temperature</td> </tr> <tr> <td style="text-align: left;">battery1WarnStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 1 warning status BIT0: Low voltage warning, BIT1: High voltage warning, BIT2: Low charging temperature warning, BIT3: High charging temperature warning, BIT4: Low discharging temperature warning, BIT5: High discharging temperature warning, BIT6: Overcurrent charging warning, BIT7: Overcurrent discharging warning, BIT8~BIT15: Reserved</td> </tr> <tr> <td style="text-align: left;">battery1ProtectStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 1 protection status BIT0: Low voltage protection, BIT1: High voltage protection, BIT2: Low charging temperature protection, BIT3: High charging temperature protection, BIT4: Low discharging temperature protection, BIT5: High discharging temperature protection, BIT6: Overcurrent charging protection, BIT7: Overcurrent discharging protection, BIT8: Battery error, BIT9: NTC disconnection, BIT10: Voltage sampling line disconnection, BIT11~BIT15: Reserved</td> </tr> <tr> <td style="text-align: left;">battery2SerialNum</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Battery pack 2 - SN</td> </tr> <tr> <td style="text-align: left;">battery2Soc</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 2 - SOC</td> </tr> <tr> <td style="text-align: left;">battery2Temp</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Battery pack 2 - Temperature</td> </tr> <tr> <td style="text-align: left;">battery2WarnStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 2 warning status BIT0: Low voltage warning, BIT1: High voltage warning, BIT2: Low charging temperature warning, BIT3: High charging temperature warning, BIT4: Low discharging temperature warning, BIT5: High discharging temperature warning, BIT6: Overcurrent charging warning, BIT7: Overcurrent discharging warning, BIT8~BIT15: Reserved</td> </tr> <tr> <td style="text-align: left;">battery2ProtectStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 2 protection status BIT0: Low voltage protection, BIT1: High voltage protection, BIT2: Low charging temperature protection, BIT3: High charging temperature protection, BIT4: Low discharging temperature protection, BIT5: High discharging temperature protection, BIT6: Overcurrent charging protection, BIT7: Overcurrent discharging protection, BIT8: Battery error, BIT9: NTC disconnection, BIT10: Voltage sampling line disconnection, BIT11~BIT15: Reserved</td> </tr> <tr> <td style="text-align: left;">battery3SerialNum</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Battery pack 3 - SN</td> </tr> <tr> <td style="text-align: left;">battery3Soc</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 3 - SOC</td> </tr> <tr> <td style="text-align: left;">battery3Temp</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Battery pack 3 - Temperature</td> </tr> <tr> <td style="text-align: left;">battery3WarnStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 3 warning status BIT0: Low voltage warning, BIT1: High voltage warning, BIT2: Low charging temperature warning, BIT3: High charging temperature warning, BIT4: Low discharging temperature warning, BIT5: High discharging temperature warning, BIT6: Overcurrent charging warning, BIT7: Overcurrent discharging warning, BIT8~BIT15: Reserved</td> </tr> <tr> <td style="text-align: left;">battery3ProtectStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 3 protection status BIT0: Low voltage protection, BIT1: High voltage protection, BIT2: Low charging temperature protection, BIT3: High charging temperature protection, BIT4: Low discharging temperature protection, BIT5: High discharging temperature protection, BIT6: Overcurrent charging protection, BIT7: Overcurrent discharging protection, BIT8: Battery error, BIT9: NTC disconnection, BIT10: Voltage sampling line disconnection, BIT11~BIT15: Reserved</td> </tr> <tr> <td style="text-align: left;">battery4SerialNum</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Battery pack 4 - SN</td> </tr> <tr> <td style="text-align: left;">battery4Soc</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 4 - SOC</td> </tr> <tr> <td style="text-align: left;">battery4Temp</td> <td style="text-align: left;">Double</td> <td style="text-align: left;">Battery pack 4 - Temperature</td> </tr> <tr> <td style="text-align: left;">battery4WarnStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 4 warning status BIT0: Low voltage warning, BIT1: High voltage warning, BIT2: Low charging temperature warning, BIT3: High charging temperature warning, BIT4: Low discharging temperature warning, BIT5: High discharging temperature warning, BIT6: Overcurrent charging warning, BIT7: Overcurrent discharging warning, BIT8~BIT15: Reserved</td> </tr> <tr> <td style="text-align: left;">battery4ProtectStatus</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Battery pack 4 protection status BIT0: Low voltage protection, BIT1: High voltage protection, BIT2: Low charging temperature protection, BIT3: High charging temperature protection, BIT4: Low discharging temperature protection, BIT5: High discharging temperature protection, BIT6: Overcurrent charging protection, BIT7: Overcurrent discharging protection, BIT8: Battery error, BIT9: NTC disconnection, BIT10: Voltage sampling line disconnection, BIT11~BIT15: Reserved</td> </tr> </tbody> </table> <p><strong>Remarks</strong></p> <ul> <li>Frequency of collection is once every 5 minutes or less.</li> </ul>

页面列表

ITEM_HTML