-
Notifications
You must be signed in to change notification settings - Fork 4
List of endpoints
The gas usage history (up to 15 years) is paged, where each page shows the daily gas usage for up to 32 days.
To determine the current page index, first retrieve the gas usage pointer:
/ecus/rrc/recordings/gasusagePointer
Next, take that value and determine the (rounded down) factor of 32 for it:
PAGE = Math.ceil(POINTER / 32)
Use the page value to retrieve the data:
/ecus/rrc/recordings/gasusage?page=PAGE
Values in the response:
-
d: date (DD-MM-YYYY) -
T: outdoor temperature × 10 -
ch: kWh (see below) used for central heating -
hw: kWh used for hot water
/ecus/rrc/recordings/yearTotal
Value is in kWh.
To convert to m³, the Easy app uses a conversion factor of 0.12307692F (kWh * 0.12307692f = m³) for natural gas, which means a calorific value of 29MJ/m³ (specifically for Dutch users, this value is rather low, and a value of 35MJ/m³ is more realistic. More information can be found on the Gasunie website).
For LPG usage, the conversion factor is 0.040742416F.
/system/sensors/temperatures/outdoor_t1
If your boiler doesn't have an outdoor temperature sensor, the values will be provided by the Nefit backend using data retrieved from a online weather service. For this, it uses the geolocation of the boiler, as supplied by the user (by means of entering a postal code in the mobile app).
To query the location, use these two endpoints:
/system/location/latitude
/system/location/longitude
/dhwCircuits/dhwA/extraDhw/supported
/dhwCircuits/dhwA/extraDhw/duration
/dhwCircuits/dhwA/extraDhw/status
/dhwCircuits/dhwA/dhwCurrentSwitchpoint
/dhwCircuits/dhwA/dhwNextSwitchpoint
/dhwCircuits/dhwA/dhwOffDuringAbsence
/dhwCircuits/dhwA/dhwOffDuringNight
/dhwCircuits/dhwA/dhwOperationManualMode
/dhwCircuits/dhwA/dhwOperationMode
/dhwCircuits/dhwA/dhwOperationType
/dhwCircuits/dhwA/dhwProgram0
/dhwCircuits/dhwA/dhwProgram1
/dhwCircuits/dhwA/dhwProgram2
/dhwCircuits/dhwA/hotWaterSystem
/dhwCircuits/dhwA/thermaldesinfect/lastresult
/dhwCircuits/dhwA/thermaldesinfect/state
/dhwCircuits/dhwA/thermaldesinfect/time
/dhwCircuits/dhwA/thermaldesinfect/weekday
/ecus/rrc/dayassunday/day
/ecus/rrc/dayassunday/day%d/active
/ecus/rrc/dayassunday/day%d/mode
/ecus/rrc/homeentrancedetection/userprofile
/ecus/rrc/installerdetails
/ecus/rrc/lockuserinterface
/ecus/rrc/personaldetails
/ecus/rrc/pirSensitivity
/ecus/rrc/pm/closingvalve/status
/ecus/rrc/pm/ignition/status
/ecus/rrc/pm/refillneeded/status
/ecus/rrc/pm/shorttapping/status
/ecus/rrc/pm/systemleaking/status
/ecus/rrc/recordings/yearTotal
/ecus/rrc/selflearning/learnedprogram
/ecus/rrc/selflearning/nextSwitchpoint
/ecus/rrc/selflearning/nextSwitchpointEndtime
/ecus/rrc/temperaturestep
/ecus/rrc/uiStatus
/ecus/rrc/userprogram/activeprogram
/ecus/rrc/userprogram/fireplacefunction
/ecus/rrc/userprogram/preheating
/ecus/rrc/userprogram/program0
/ecus/rrc/userprogram/program1
/ecus/rrc/userprogram/program2
/ecus/rrc/userprogram/userswitchpointname1
/ecus/rrc/userprogram/userswitchpointname2
/ecus/rrc/weatherDependent/basePointSupply
/ecus/rrc/weatherDependent/endPointSupply
/ecus/rrc/weatherDependent/forcedSwitchedOff
/ecus/rrc/weatherDependent/maxSupply
/ecus/rrc/weatherDependent/minSupply
/ecus/rrc/weatherDependent/nightSwitchOff
/ecus/rrc/weatherDependent/roomInfluence
/ecus/rrc/weatherDependent/summerSwitchOff
/gateway/brandID
/gateway/remote/installername
/gateway/remote/servicestate
/gateway/remote/sid
/gateway/remote/sidexptime
/gateway/remote/tempsid
/gateway/remote/tempsidexptime
/gateway/serialnumber
/gateway/time/timezone
/gateway/update/strategy
/gateway/uuid
/gateway/versionFirmware
/gateway/versionHardware
/heatingCircuits/hc1/actualSupplyTemperature
/heatingCircuits/hc1/control
/heatingCircuits/hc1/holidayMode/activated
/heatingCircuits/hc1/holidayMode/end
/heatingCircuits/hc1/holidayMode/start
/heatingCircuits/hc1/holidayMode/status
/heatingCircuits/hc1/holidayMode/temperature
/heatingCircuits/hc1/manualTempOverride/status
/heatingCircuits/hc1/manualTempOverride/temperature
/heatingCircuits/hc1/operationMode
/heatingCircuits/hc1/temperatureAdjustment
/heatingCircuits/hc1/temperatureRoomManual
/heatingCircuits/hc1/type
/heatingCircuits/hc1/usermode
/notifications
/system/appliance/boilermaintenancerequest
/system/appliance/causecode
/system/appliance/cm/type
/system/appliance/cm/version
/system/appliance/displaycode
/system/appliance/serialnumber
/system/appliance/systemPressure
/system/appliance/type
/system/appliance/version
/system/interfaces/ems/brandbit