REST-API Messages vom BSH-Controller

[Stefan71242]

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 👋🤓

[SebastianHarder · Accepted solution]

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 Licht-/Rollladensteuerung II - Lichtsteuerung mit der deviceId aufpassen musst, weil dort das "parent device" genutzt werden muss. 

Viele Grüße
Sebastian

[Stefan71242]

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 👋🤓

[SebastianHarder]

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 

[Stefan71242]

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



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