Private Nachrichten an Forum-Moderation nicht möglich

[Stefan71242]

Hallo@Ulrike , leider geht das Senden von Nachrichten an euch weiterhin nicht möglich (Browser Edge und Firefox, jeweils aktuellste Versionen):

daher auf diesem Wege eine Frage REST-API Dokumentation / Heizplänen:

Hallo Ulrike 🤗,

bei der REST-API Schnittstelle sind ja ein paar "Baustellen" bezüglich Dokumentation offen, z.B. ein  GET {{shc_api}}/climate/schedule/roomClimateControl_hz_11/activeSchedule  liefert im Postman 200 OK, aber das Ergebnis hilft mir nicht wirklich weiter:

{

    "scheduleData": [],

    "hasFreeScheduleSlots": true

}

Wie bekommt man die Heizpläne abgerufen? Ich habe alles Mögliche mit climate/schedule/ probiert, komme aber einfach nicht weiter (KI gibt mittlerweile auch auf 😂). Ich vermute mal, dass es für den Bereich scheduleData einen eigenen REST-API Befehl gibt? Für einen Tipp / Beispiel wäre echt dankbar 👍.

Gibt es generell eine erweiterte REST-API Dokumentation, die man als BSH-Nutzer erhalten könnte?  Die hier https://local.apidocs.bosch-smarthome.com/ ist ja doch schon etwas in die Jahre gekommen 😁.

Vorab danke für jede Antwort und viele Grüße, Stefan 👋🤓

[tobo123]

---

@Stefan71242  schrieb:

Wie bekommt man die Heizpläne abgerufen?

---

Das ging tatsächlich mal, ich meine durch ein GET auf /devices/roomClimateControl_hz_xxx/services/RoomClimateControl. Da kam dann eine ziemlich lange Antwort mit allen Zeitplänen. Das war der Grund, warum ich bei meinem ESP-Projekt lange Zeit die SOLL-Temperatur nicht richtig ausgewertet bekommen habe, weil die Antwort meinen Eingangsbuffer gesprengt hat.

Jetzt ist die Antwort viel kürzer. Hier scheint also die API bei einem der letzten Updates geändert worden zu sein. Dem Wunsch nach einer Doku schließ ich mich da gerne an.

[Stefan71242]

Hallo @SebastianHarder,
gibt es hier wirklich keine Möglichkeit mehr, per REST-API die Heizpläne abzurufen 😯?
"Jetzt ist die Antwort viel kürzer. Hier scheint also die API bei einem der letzten Updates geändert worden zu sein."

[Stefan71242]

Hallo @Ulrike oder @SebastianHarder, bekomme ich noch eine Antwort auf meine Anfrage? 

Vor allem auf diese Frage, da ich diese bereits mehrfach gestellt habe:
Wie bekommt man die Heizpläne per REST-API abgerufen?

Danke vorab und viele Grüße 👋🤓

[Maurice]

Sebastian ist im Urlaub und Ulrike für solche Fragen wahrscheinlich eher nicht die richtige Ansprechpartnerin.

[ChristophBoese]

Hallo @Stefan71242 , hallo @tobo123 ,

eigentlich updaten wir unsere api regelmäßig, aber hier haben wir offenbar eine große Lücke.

Probiert mal bitte 
GET {{shc_api}}/climate/schedule/roomClimateControl_hz_11/heating

bzw

GET {{shc_api}}/climate/schedule/roomClimateControl_hz_11/cooling
Das Ergebniss sollte JSON sein vergleichbar mit folgendem:

{
"activeScheduleId": "cea86ded-e053-49ef-8c35-6eb8a34cb587",
"scheduleData": [
{
"@type": "scheduleData",
"id": "42576543-dd41-4262-8997-713cded69b86",
"profiles": [
{
"day": "MONDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 480,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 960,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 1200,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
}
]
},
{
"day": "TUESDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 480,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 960,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 1200,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
}
]
},
{
"day": "WEDNESDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 480,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 960,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 1200,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
}
]
},
{
"day": "THURSDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 480,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 960,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 1200,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
}
]
},
{
"day": "FRIDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 480,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 960,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 1200,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
}
]
},
{
"day": "SATURDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 480,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 960,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 1200,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
}
]
},
{
"day": "SUNDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 480,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 960,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
{
"startTimeMinutes": 1200,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
}
]
}
],
"attributeExtensionMap": {
"ScheduleType": "SYSTEM",
"ClimateRoomControlMode": "HEATING"
}
},
{
"@type": "scheduleData",
"id": "0698e1f2-7ab9-4da0-b5c9-512f715f7106",
"name": "Hdhdh",
"profiles": [
{
"day": "MONDAY",
"switchPoints": [
{
"startTimeMinutes": 0,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 17.0
}
},
{
"startTimeMinutes": 360,
"value": {
"@type": "temperatureSwitchPointValue",
"temperature": 21.0
}
},
...

...

...
]
}
],
"attributeExtensionMap": {
"ScheduleType": "CUSTOM",
"ClimateRoomControlMode": "HEATING"
}
}
],
"hasFreeScheduleSlots": false
}

Aus dem JSON kann man sich dann mit activeScheduleId den Schedule ziehen.
Zumindest für das abrufen sollte es so funktionieren, die restlichen Steuermöglichkeiten können wir hoffentlich schnell in unserer Doku nachziehen.

[Stefan71242]

Hallo @ChristophBoese , bei mir funktioniert das auch. Die Doku zu aktualisieren wäre echt prima 🤗. Vielen Dank für den Hinweis 👍.  Viele Grüße, Stefan 👋🤓

[Stefan71242]

Hallo  @ChristophBoese , eine Frage habe ich:

Wo erkenne ich, dass ein Raum auf automatischem Zeitplan steht und nicht im manuellen Modus?
Bei PowerState, z.B. bei einem Zwischenstecker, kann ich das hiermit abfragen:

    {

        "@type": "DeviceServiceData",

        "id": "PowerSwitchProgram",

        "deviceId": "hdm:ZigBee:385b44fffeaf0b06",

        "state": {

            "@type": "powerSwitchProgramState",

            "operationMode": "SCHEDULE", (oder MANUAL)

Wie kann ich das aber beim einem Raum bzw. Raumthermostat (z.B. BWTH) erkennen?
Ich finde weder unter Services noch unter den Schedules[] einen Eintrag.
Danke vorab 😊

Meine Anfrage hat sich erledigt; ich habe es herausgefunden:

Mit GET {{shc_api}}/devices/roomClimateControl_hz_3/services/RoomClimateControl/state
bekomme ich :

{

    "@type": "climateControlState",

    "operationMode": "AUTOMATIC",

    "setpointTemperature": 22.0,

    "ventilationMode": false,

    "low": false,

    "boostMode": false,

    "summerMode": false,

    "supportsBoostMode": false,

    "roomControlMode": "HEATING",

    "activeScheduleId": "08c4766a-e810-4ae6-94f1-399b9d5ccc0e",

    "setPointTemperatureOffset": 0.0,

    "isSetPointTemperatureOffsetActive": false,

    "setPointTemperatureOffsetActiveValue": 0.0,

    "nextSetPointTemperatureChange": "2026-02-20T19:00:00Z",

    "nextChange": {

        "nextSetpointTemperature": 17.0,

        "nextOperationMode": "AUTOMATIC",

        "nextSetPointTemperatureChange": "2026-02-20T19:00:00Z"

    }

}

[tobo123]

Hallo Christoph, das funktioniert 👍. Wäre cool, wenn der Endpunkt mit in die Doku und idealerweise auch in die Postman Collection käme.