Monitoring API release notes

OpenAPI/Swagger description

Version 1.16.0 (2023-05-23)

  • New property in (GET /monitoring/v1/plants/{plantId}/installation) endpoint:

    • calculatedAcNominalPower - Nominal AC power of the plant in [W], calculated as the sum of the individual AC powers of all active PV inverters.

  • Support for the functionalities of the Sunny Home Manager in ennexOS:

    • Consumer devices

Version 1.15.0 (2023-03-29)

  • Sunny Portal system migration (SunnyPortal classic to Sunny Portal powered by ennexOS): 

    • Plant/system-list is automatically filtered for migrated systems and contains the new plantIds from Sunny Portal powered by ennexOS

    • Permanent Redirect for migrated classic systems: 

      • API-response returns an HTTP code 308 without a response body

      • New plantId/deviceId in location header, including any query params.

    • More details on MigrationAnnouncement (sma.de)

  • Bugfix for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/installation) – co2SavingsFactor is missing from plants/installation response object

  • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurement/sets/EnergyMix/{period}) –now available for ennexOS devices too.

Version 1.14.2 (2023-01-25)

  • Bugfix for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/logs) – Some log messages have returned inacurate data

  • Documentation improvements

Version 1.14.1 (2023-01-12)

  • Bugfix for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/installation) – Validation error due to incorrect value ranges for the azimuth property

Version 1.14.0 (2023-01-10)

  • Bugfix for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/measurements/sets/EnergyBalance) – missing or incorrect Total property in some ennexOS systems

  • New property in (GET /monitoring/v1/plants/{plantId}/installation) endpoint:

    • pvModuleAreas - List of the PV modules, supported only in ennexOS systems

Version 1.13.2 (2022-10-19)

  • Bugfix for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/measurements/sets/EnergyBalance) – Improvement for systems without PV generation

Version 1.13.0 (2022-09-28)

  • Bugfixes for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/configuration) - plantWithBattery property takes into account whether a battery device is active

    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets/PowerAc) - Fallback for missing VoltagePhaseA values

    • Endpoint (GET /monitoring/v1/plants/{plantId}/measurements/sets/EnergyBalance) - Improvement for Week-hourly WithTotal calls

  • SmartConnected info within the following endpoints:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/devices) - SmartConnected-capability of devices

    • Endpoint (GET /monitoring/v1/plants/{plantId}/configuration) - SmartConnected-status of the system

    • Endpoint (GET /monitoring/v1/plants/{plantId}/stakeholders) - SmartConnected-stakeholders

Version 1.12.1 (2022-07-20)

  • Bugfixes for:

    • Endpoint (GET /monitoring/v1/plants/{plantId}/logs; …devices/{deviceId}/logs) - Change the log access level of the custom flow client user, from standard to installer

    • Endpoint (GET /monitoring/v1/plants/{plantId}/communication) - issues with partial timeouts

    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets) - No access to the satellite sensor

    • Endpoint (GET /monitoring/v1/plants) - deliver partial result if only classic or only ennexOS is not available

Version 1.12.0 (2022-06-28)

  • New property in (GET /monitoring/v1/plants/{plantId}/installation) endpoint:

    • co2SavingsFactor - The CO2 savings factor [g/kWh] indicates how much CO2 is produced when generating one kilowatt hour of electricity, or how much CO2 was not produced by the environmentally friendly electricity generation of your PV system

  • New property in (GET /monitoring/v1/plants/{plantId}/configuration) endpoint:

    • plantWithLiveData - True, if the plant supports live data, false otherwise. Currently only classic WebConnect and Home-Manager systems support live data

Version 1.11.0 (2022-05-17)

  • Documentation improvements

  • Device status value improvements

  • Bugfixes for:

    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets) - delivers partly unsupported measurement sets

    • Endpoint (GET /monitoring/v1/devices/{deviceId}/measurements/sets/PowerDc) - delivers partly wrong timestamps and/or no values