Hallo zusammen, da es in so vielen Verschiedenen Themen anfragen gibt wie man etwas über die Cloud machen kann, werde ich hier nun alle mir bekannten zusammenfassen.
Sollte jemand noch etwas anderes brauchen, schreibt mir eine Nachricht und ich werde schauen ob und wie es eine Möglichkeit gibt.
Da es viele verschiedene Kombinationen und auch Möglichkeiten gibt, werden nicht alle ausführlich hier stehen.
Ich werde es aber in Gruppen unterteilen.
Es werden immer gebraucht:
- Die Servernummer
- der Autorisierungs-Schlüssel (ab hier nur noch auth_key)
- IDS -> von Geräten/Devices , Szenen (dazu zählen Alarme und Thermostate)
Bitte sucht in den Verschiedenen Bereichen, es ist mehrfach und unterschiedlich erklärt wie man an alles ran kommt.
Um etwas in der Cloud zu erreichen haben wir Zwei Varianten, einmal die HTTP.get und die HTTP.post.
Die Get liefert uns meistens Informationen (Ausnahmen gibt es dennoch) ansonsten benötigen wir fast immer die Post Variante.
Da man die Get auch als Post senden kann werde ich hier nur zweites erklären/anwenden.
Der Aufbau:
- Die URL: https://shelly-X-eu.shelly.cloud (X steht für eure Servernummer)
- Der Request Body Typ ist: x-www-form-urlencoded
- Zuletzt noch die Body Daten (folgen)
Die URL verändert sich je nach Aufgabe und Bereich, sie wird erweitert.
Beispiel für die Erweiterung:
https://shelly-X-eu.shelly.cloud/device/thermostat/control
| Erweiterung | body Name | body Wert | Erklärung | |
| /scene/list | auth_key | Dein Key | Übersicht aller Szenen | |
| /scene/get | auth_key | Dein Key | Zeigt nur die Szene mit der Angegebenen ID | |
| id | 13 Zahlen (Szenen ID) | |||
| /scene/delete | auth_key | Dein Key | Löscht diese Szene | |
| id | (Ihr merkt, die ID ist auch immer dabei) | |||
| /scene/manual_run | auth_key | Startet diese Szene | ||
| id | ||||
| /scene | auth_key | de-/aktiviert Szenen und Thermostate (Alarme gingen auch mal so) Siehe Bulk_enable | ||
| id | ||||
| enabled | true | (aktiviert) | ||
| false | (deaktiviert) | |||
| /scene/bulk_enable | auth_key | Kann mehrer Szenen,Thermostate und Alarme gleichzeitig de-/aktiviern. (links) Kann aber auch nur für ein Alarm verwendet werde. (rechts) | ||
| enabled | true | |||
| false | ||||
| ids | ["13Zahlen","13Zahlen"] | ["13Zahlen"] | ||
| /scene/add | auth_key | Kann man Theoretisch Szenen mit erstellen. | ||
| scene_script | zu viele Varianten und zu lang. | |||
| /scene/edit | auth_key | Kann man eine Szene mit bearbeiten | ||
| id | ||||
| scene_script | siehe oben | |||
| /v2/scenes/thermostats | auth_key | Übersicht der der Thermostate (ohne Namen) -aktiv oder nicht -aktuelle Temp. - Eingestellte Temp. | ||
| /device/thermostat/control | auth_key | Temperatur eines Thermostat einstellen. | ||
| id | ||||
| temp | wunsch Temp. z.B. 18.5 (18,5°C) | |||
Devices (Bedienung):
(mit Gen1 getestet, bei gelegenheit kann noch Gen2 geprüft werden)
| Erweiterung | body Name | body Wert | Erklärung | |
| /device/relay/control | auth_key | Ein/Aus Schalten eines Gerät mit Relay. Timer Optional (bei nicht verwendung timeout weglassen) | ||
| id | 12 Stellen (Device ID) | |||
| turn | on | (an) | ||
| off | (aus) | |||
| channel | 0 | (Kanal 1) | ||
| 1 | (Kanal 2) | |||
| timeout | z.b. 30000 | (=30s) | ||
| device/light/control | siehe oben | Für Geräte ohne Relay (Komandos Identisch mit Relay) | ||
| /device/relay/roller/settings/topos | auth_key | Im Shutter Mode zur Gewünschten Position fahren | ||
| id | 12 Stellen | |||
| pos | 1 bis 100 | (entspricht den %) | ||
| /device/relay/control/bulk_control | auth_key | Mehrere Geräte Gleichzeitig schalten. ACHTUNG: Benötigt mehr Infos in devices. | ||
| turn | on | (an) | ||
| off | (aus) | |||
| devices | [{"id":"12Stellen","channel":"0","type":"SHSW-1"},{....}] | Muss alles Enthalten | ||
| /device/light/bulk_control | auth_key | Mehrere Geräte von Typ Relay und Light schalten. id Reicht hier aus. (Mehr Kanal muss geprüft werden) | ||
| turn | on | (an) | ||
| off | (off) | |||
| devices | [{"id":"12Stellen"},{...}] | |||
| /device/relay/roller/bulk_control | auth_key | Mehrere Shutter öffnen oder schließen | ||
| direction | open | (öffnen) | ||
| close | (schließen) | |||
| devices | [{"id":"12Stellen"},{...}] | |||
Einstellungen Ändern:
folgt.
Informationen:
folgt.
Wird weiter ergänzt, wenn Zeit vorhanden ist 
