Thema "Betreff: REST-API Messages vom BSH-Controller" in Projekte, REST API und Co.

REST-API Messages vom BSH-Controller

Stefan71242 — Fri, 14 Nov 2025 10:17:00 GMT

Hallo @SebastianHarder ,

Die Rückantwort bei dem REST-API Befehl messages sieht z.B. so aus:
{

"@type": "message",

"id": "060ace2b-8f64-4481-bead-4f684f2b91c1",

"messageCode": {

"name": "BATTERY_LOW",

"category": "INFO"

"sourceType": "DEVICE",

"sourceId": "hdm:ZigBee:000d6f001370be30",

"sourceName": "Bewegungsmelder TechnikKG",

"location": "Technikraum",

"timestamp": 1761662971587,

"flags": [

"USER_ACTION_REQUIRED",

"STATUS",

"STICKY"

"arguments": {

"deviceModel": "MD",

"deviceServiceDataModel": "{\"@type\":\"DeviceServiceData\",\"id\":\"BatteryLevel\",\"deviceId\":\"hdm:ZigBee:000d6f001370be30\",\"faults\":{\"entries\":[{\"type\":\"LOW_BATTERY\",\"category\":\"WARNING\"}]},\"path\":\"/devices/hdm:ZigBee:000d6f001370be30/services/BatteryLevel\"}"

}

{

"@type": "message",

"id": "6393a1d7-1f0d-4139-97e5-1049dc0bd246",

"messageCode": {

"name": "MANUAL_FIRMWARE_UPDATE",

"category": "SW_UPDATE"

"sourceType": "DEVICE",

"sourceId": "hdm:ZigBee:842712fffe24c0b9",

"timestamp": 1760629885813,

"flags": [

"STATUS"

"arguments": {

"deviceModel": "MICROMODULE_RELAY",

"firmwareUpdateState": "UpToDate"

}

In diesem Beispiel haben wir 2 Mitteilungen:
1. Batterie Low für Bewegungsmelder TechnikKG
2. SW_UPDATE für ein Relais

Leider - und aus meiner Sicht ein Bug - kommt bei der 2. Mitteilung kein Name (sourceName) und keine Location (sourceLocation), obwohl diese ja eindeutig bei jedem Device vorhanden sind (das Relais und andere Geräte haben einen Namen und eine Raumzuteilung). Kann man da auf ein Update mit einem der nächsten Relaises hoffen?

Gibt es eigentlich eine REST-API Befehl für die neue Funktion Stromverbrauchswerte zurücksetzen?
In der REST-API Dokumentation finde ich nichts.

Danke vorab und viele Grüße 👋🤓

Betreff: REST-API Messages vom BSH-Controller

SebastianHarder — Mon, 17 Nov 2025 10:50:44 GMT

Hallo @Stefan71242,

die /messages API ist ziemlich komplex. Die beiden aus deiner Sicht fehlenden Attribute, kann sich unsere App anhand der sourceId dynamisch laden. Wieso die eine Nachricht die Attribute enthält und die andere nicht, kann ich aktuell nicht sagen. Bitte habe aber Verständnis, dass wir aufgrund eines einzelnen Feedbacks, hier eher nicht aktiv werden.

Bzgl. Stromverbrauchswerte zurücksetzen kannst du es mit folgender API probieren:

POST /smarthome/devices/<deviceId>/services/PowerMeter/operation/resetEnergySummation

Wobei du bei der mit der deviceId aufpassen musst, weil dort das "parent device" genutzt werden muss.

Viele Grüße
Sebastian

Betreff: REST-API Messages vom BSH-Controller

Stefan71242 — Mon, 17 Nov 2025 12:37:49 GMT

Die fehlende Werte hole ich jetzt auch dynamisch 🤗 Hätte ja sein können, dass es ein Bug ist oder es einen Trick gibt, immer alle Werte zu erhalten...

Das Zurücksetzen funktioniert damit, vielen Dank:

POST /smarthome/devices/<deviceId>/services/PowerMeter/operation/resetEnergySummation

Gibt es neben dieser Dokumentation https://local.apidocs.bosch-smarthome.com/

noch eine andere, weil da finde ich den Befehl POST services/PowerMeter/operation/resetEnergySummation nicht.

Viele Grüße, Stefan 👋🤓

Betreff: REST-API Messages vom BSH-Controller

SebastianHarder — Mon, 17 Nov 2025 13:28:43 GMT

Freut mich, dass es geklappt hat.

Die Dokumentation ist nicht vollständig. Das ist aber ein Thema, womit wir uns beschäftigen – auch aufgrund des EU Data Acts.

Viele Grüße

Sebastian

Betreff: REST-API Messages vom BSH-Controller

Stefan71242 — Mon, 17 Nov 2025 15:29:18 GMT

Endlich nicht mehr händisch alle einzeln zurücksetzen 😀

Falls du noch mehr nicht dokumentierte REST-API Aufrufe hast, gerne her damit 😁👍