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