ShineServer_English version


Obtain real-time data of smart meters according to

<p><strong>A brief description:</strong> </p> <p>-Interface to obtain real-time data of smart meters according to the collector SN and smart meter addresses -<code>Only applicable to devices with device type 3 returned in the 3.3 interface.</code></p> <p><strong>Request URL:</strong> -<code>http(s)://test.growatt.com/v1/device/ammeter/meter_last_data</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;">datalog_sn</td> <td style="text-align: left;">yes</td> <td style="text-align: left;">int</td> <td>collector SN</td> </tr> <tr> <td style="text-align: left;">address</td> <td style="text-align: left;">is</td> <td style="text-align: left;">int</td> <td>device address</td> </tr> </tbody> </table> <p><strong>Return example</strong></p> <pre><code>{ "data": { "reactivePower": 168.89999389648438, "forwardActiveNeed": 0, "currentL3Need": 0, "l3CurrentHarmonic": 0, "voltageL1": 0, "activePower": 5589.60009765625, "voltageL2": 0, "voltageL3": 0, "apparentEnergyNeed": 0, "voltageUbc": 0, "l2VoltageHarmonic3": 0, "gridEnergy": 0, "activePowerMaxNeedOne": 0, "activeEnergy": 48.900001525878906, "activePowerNeedOne": 0, "powerFactorL1": 0, "voltage": 0, "feiLvBoZEnergy": 15.899999618530273, "powerFactorL3": 0, "powerFactorL2": 0, "reverseActiveNeed": 0, "feiLvPingZEnergy": 6.5, "voltageUab": 0, "bActivePower": 0, "forwardActiveMaxNeed": 0, "totalReactiveEnergyL3": 0, "reverseActiveTotalEnergy": 0, "totalEnergy": 0, "totalReactiveEnergyL1": 0, "totalReactiveEnergyL2": 0, "currentL3": 0, "cPowerFactor": 0, "aReactivePower": 0, "apparentEnergy": 0, "current": 0, "feiLvFengZEnergy": 10.199999809265137, "instantlyTotalActivePower": 0, "timeText": "2019-01-09 15:00:34", "dataLogSn": "CRAZT00001", "apparentEnergyMaxNeed": 0, "bReactivePower": 0, "bPowerFactor": 0, "posiActivePower": 0, "currentL1": 0, "currentHarmonicAvg": 0, "l3Voltage1": 0, "currentL2": 0, "currentMaxNeed": 0, "zeroLineMaxNeed": 0, "voltageUca": 0, "aPowerFactor": 0, "reactivePowerL2": 0, "reactivePowerL3": 0, "reactivePowerL1": 0, "currentL1Need": 0, "aCurrent": 0, "l3VoltageHarmonic1": 0, "addr": 1, "currentIc": 0, "l2VoltageHarmonic": 0, "currentIb": 0, "currentIa": 0, "positiveActiveTotalEnergy": 0, "powerFactor": 0.9991999864578247, "l2Voltage3": 0, "activePowerNeed": 0, "instantaneousTotalApparentPower": 0, "gridFrequency": 0, "aActivePower": 0, "lineVoltageHarmonicAvg": 0, "posiReactivePower": 0, "currentL1MaxNeed": 0, "apparentPowerL1": 0, "apparentPowerL2": 0, "apparentPowerL3": 0, "l2CurrentHarmonic": 0, "zeroLineNeed": 0, "cReactivePower": 0, "l1VoltageHarmonic2": 0, "activePowerL3": 0, "reactiveEnergy": 0.10000000149011612, "activePowerL1": 0, "l1CurrentHarmonic": 0, "l1VoltageHarmonic": 0, "activePowerL2": 0, "reverseActiveMaxNeed": 0, "cActivePower": 0, "frequency": 0, "currentL2MaxNeed": 0, "voltageHarmonicAvg": 0, "currentNeed": 0, "apparentPower": 6025.5, "reverActivePower": 0, "currentL2Need": 0, "calendar": { "minimalDaysInFirstWeek": 1, "weekYear": 2019, "time": { "time": 1547017234000, "minutes": 0, "seconds": 34, "hours": 15, "month": 0, "year": 119, "timezoneOffset": -480, "day": 3, "date": 9 }, "weeksInWeekYear": 52, "gregorianChange": { "time": -12219292800000, "minutes": 0, "seconds": 0, "hours": 8, "month": 9, "year": -318, "timezoneOffset": -480, "day": 5, "date": 15 }, "timeZone": { "lastRuleInstance": null, "rawOffset": 28800000, "DSTSavings": 0, "dirty": false, "ID": "Asia/Shanghai", "displayName": "China Standard Time" }, "timeInMillis": 1547017234000, "lenient": true, "firstDayOfWeek": 1, "weekDateSupported": true }, "l1Voltage2": 0, "voltageUb": 0, "voltageUa": 0, "totalActiveEnergyL1": 0, "voltageUc": 0, "aVoltage": 0, "totalActiveEnergyL3": 0, "totalActiveEnergyL2": 0, "activePowerMaxNeed": 0, "l3VoltageHarmonic": 0, "feiLvGuZEnergy": 5.400000095367432, "reverReactivePower": 0, "userEnergy": 0, "instantlyTotalReactivePower": 0, "currentL3MaxNeed": 0 }, "error_code": 0, "datalogger_sn": "CRAZT00001", "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;">dataLogSn</td> <td style="text-align: left;">int</td> <td>The collector SN of the smart meter</td> </tr> <tr> <td style="text-align: left;">datalogger_sn</td> <td style="text-align: left;">string</td> <td>Collector serial number</td> </tr> <tr> <td style="text-align: left;">addr</td> <td style="text-align: left;">string</td> <td>Smart meter device address</td> </tr> <tr> <td style="text-align: left;">timeText</td> <td style="text-align: left;">string</td> <td>Last update time</td> </tr> <tr> <td style="text-align: left;">reactivePower</td> <td style="text-align: left;">int</td> <td>reactive power</td> </tr> <tr> <td style="text-align: left;">reactiveEnergy</td> <td style="text-align: left;">int</td> <td>Reactive energy</td> </tr> <tr> <td style="text-align: left;">gridEnergy</td> <td style="text-align: left;">string</td> <td>Grid-side electricity</td> </tr> <tr> <td style="text-align: left;">totalEnergy</td> <td style="text-align: left;">string</td> <td>Total energy of the meter</td> </tr> <tr> <td style="text-align: left;">feiLvGuZEnergy</td> <td style="text-align: left;">string</td> <td>Rate Valley Positive Active Power</td> </tr> <tr> <td style="text-align: left;">activeEnergy</td> <td style="text-align: left;">string</td> <td>active energy</td> </tr> <tr> <td style="text-align: left;">activePower</td> <td style="text-align: left;">string</td> <td>active power</td> </tr> <tr> <td style="text-align: left;">feiLvBoZEnergy</td> <td style="text-align: left;">string</td> <td>Rate wave forward active power</td> </tr> <tr> <td style="text-align: left;">powerFactor</td> <td style="text-align: left;">string</td> <td>Power factor</td> </tr> <tr> <td style="text-align: left;">userEnergy</td> <td style="text-align: left;">string</td> <td>User-side power</td> </tr> <tr> <td style="text-align: left;">apparentPower</td> <td style="text-align: left;">string</td> <td>Apparent Power</td> </tr> <tr> <td style="text-align: left;">feiLvFengZEnergy</td> <td style="text-align: left;">string</td> <td>Rate peak positive active power</td> </tr> <tr> <td style="text-align: left;">feiLvPingZEnergy</td> <td style="text-align: left;">string</td> <td>The rate is flat positive active power</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: collector SN error, 10003: device address is empty, 10004: collector does not exist</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>

页面列表

ITEM_HTML