Thema "Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API" in Projekte, REST API und Co.

Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

ijonmichy — Sun, 25 Jan 2026 13:54:34 GMT

Hallo zusammen!

Über die Bosch Smart Home App, ist es möglich, den Sollwert an einem Raumthermostat (II) für eine begrenzte Zeit manuell zu setzen (Über den "Stoppuhr"-Button). Der automatische Zeitplan wird dann für einen begrenzten Zeitraum überschrieben. Nach Ablauf der eingestellten Zeit wechselt der Thermostat wieder zurück auf "Automatisch".

Meine Frage ist nun: Kann man dieses Verhalten auch mit der REST API erwirken?

Zumindest wenn ich den Status (der RoomClimateControl) auslese, sehe ich, dass das eingestellt ist, z.B.:
'customDuration': {

'customDurationActive': True,

'customDurationActiveSince': '2026-01-25T12:09:04.052673Z'

}, 'nextChange': {

'nextSetpointTemperature': 16.0,

'nextOperationMode': 'AUTOMATIC',

'nextSetPointTemperatureChange': '2026-01-25T13:10:00Z'

}

Daher vermute ich, dass das Verhalten von dem SHC verwaltet wird (und nicht von der App). Aber ich habe keine Dokumentation gefunden, wie ich das über die REST API setzen kann.
Oder steuert das doch die App? (Und ich muss die Logik in meinem Projekt selbst programmieren?)

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

SebastianHarder — Sun, 25 Jan 2026 18:42:14 GMT

Hallo @ijonmichy,

ja, das geht über die REST-API.

Probiers mal mit einem POST-Request auf /devices/<roomClimateControlId>/services/PowerSwitchProgram/operation/turnOnTemporarily.

Viele Grüße
Sebastian

P.S. deine Vermutung war richtig. Es wäre zu unzuverlässig, der App das automatische Ausschalten zu überlassen. Es gibt ja keine Garantie, dass diese zum richtigen Zeitpunkt eine Verbindung zum SHC herstellen kann.

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

ijonmichy — Sun, 25 Jan 2026 19:54:19 GMT

Super! Danke für die schnelle Antwort.

Kannst du mir auch sagen, wie das json strukturiert ist, das ich im body senden muss? (Hab die Struktur von climateControlState ausprobiert. Aber ich weiß nicht, wie ich die Zeit definiere, bei der wieder auf Automatik geschaltet werden soll.)

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

SebastianHarder — Sun, 25 Jan 2026 21:07:41 GMT

Guter Punkt! Ich glaube, nur die Dauer in Sekunden.

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

ijonmichy — Tue, 27 Jan 2026 20:01:58 GMT

Also nur die Dauer in Sekunden? Und die Temperatur? (Oder setze ich erst die Temperatur und steuere dann den PowerSwitchProgram-Endpunkt an?)
Wenn ich nur einen Zahlenwert übergebe, bekomme ich jedenfalls Fehler 422

{ "@type":"JsonRestExceptionResponseEntity", "errorCode":"JSON_MAPPING_FAILED", "statusCode":422 }

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

ijonmichy — Sun, 01 Feb 2026 13:23:48 GMT

{ "@type":"JsonRestExceptionResponseEntity", "errorCode":"JSON_MAPPING_FAILED", "statusCode":422 }

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

SebastianHarder — Sun, 01 Feb 2026 19:55:55 GMT

Okay, sorry, ich habe wo ganz falsches geschaut.

Die Operation für den RoomClimateControl DeviceService lautet

startCustomDuration

und muss um zwei Parameter im Body als Array ergänzt werden:

1. die Temperatur, z. B. "21.5"

2. der Zeitpunkt, bis wann die Temperatur gelten soll, z. B. "2027-12-03T10:15:30+01:00"

Ich hoffe, so klappt es.

POST /devices/<roomClimateControlId>/services/RoomClimateControl/operation/startCustomDuration

Body:
[ 22.5, "2027-12-03T10:15:30+01:00" ]

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

ijonmichy — Sun, 01 Feb 2026 20:45:24 GMT

Perfekt! Das funktioniert. Vielen Dank 🙂

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

Stefan71242 — Tue, 03 Feb 2026 08:35:33 GMT

Wie frage ich per REST-API die Schaltzeiten von einem RoomClimateControl Service ab? Bei z.B. einem Zwischenstecker klappt das mit

$"devices/{{device_id}}/services/PowerSwitchProgram"

Bei einem RoomClimateControl bekomme ich die Schedule-ID z.B.

{

"@type": "DeviceServiceData",

"id": "RoomClimateControl",

"deviceId": "roomClimateControl_hz_11",

"state": {

"@type": "climateControlState",

"operationMode": "AUTOMATIC",

"setpointTemperature": 22.0,

"ventilationMode": false,

"low": false,

"boostMode": false,

"summerMode": false,

"supportsBoostMode": false,

"roomControlMode": "HEATING",

"activeScheduleId": "b3a8492a-edf4-498c-966c-68f11debf223",

"setPointTemperatureOffset": 0.0,

"isSetPointTemperatureOffsetActive": false,

"setPointTemperatureOffsetActiveValue": 0.0,

Aber wie frage ich den Schaltplan für diese ID ab?

Ich habe alle Services vom RoomClimateControl und auch dem zugehörigen Thermostat im Raum ausprobiert, leider ohne Erfolg.

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

SebastianHarder — Tue, 03 Feb 2026 08:42:39 GMT

Probier's bitte mal mit GET /climate/schedule/roomClimateControl_hz_1/<scheduleId>

Betreff: Raumthermostat II: Zeitbegrenzte manuelle Steuerung via REST API

Stefan71242 — Tue, 03 Feb 2026 09:15:04 GMT

Hallo @sebastian, auf
{{shc_api}}/climate/schedule/roomClimateControl_hz_11/b3a8492a-edf4-498c-966c-68f11debf223

bekomme ich "nur" das zurück:

{

"scheduleData": [],

"hasFreeScheduleSlots": true

}

Die Räume stehen alle auf Automatisch mit jeweils einem Heizplan.

Hier kann ich scheinbar (statt der ScheduleID) alles anhängen, was ich will, denn auch das bringt das mit 200 OK das gleiche Ergebnis:
GET /climate/schedule/roomClimateControl_hz_1/testwort