# \[Tutorial\] Shelly remote über Cloud API mit Homey steuern

**URL:** <https://community.homey.app/t/tutorial-shelly-remote-uber-cloud-api-mit-homey-steuern/89187>\
**Category:** 🇩🇪 Deutsch (German)\
**Created:** [September 11, 2023, 11:38am UTC](https://community.homey.app/t/tutorial-shelly-remote-uber-cloud-api-mit-homey-steuern/89187 "2023-09-11T11:38:27Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![schmucke](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/schmucke/32/79913_2.png) [@schmucke](https://community.homey.app/u/schmucke)\
**Post date:** [September 11, 2023, 11:38am UTC](https://community.homey.app/t/tutorial-shelly-remote-uber-cloud-api-mit-homey-steuern/89187/1 "2023-09-11T11:38:28Z")

</div>

Da es nun schon öfter zur Frage kam, wie man Shellys an einem anderen Ort steuern kann, packe ich das Ganze mal in eine kleine Anleitung. Diese Anleitung beschreibt das Steuern eines Gerätes außerhalb Eures Netzwerks. Der Shelly muss am anderen Ort natürlich mit dem Internet und der Shellycloud verbunden sein.

Als Erstes wird der Shelly API Key benötigt, nur mit diesem habt Ihr Zugriff auf Eure Geräte. Dazu logt Ihr Euch entweder in die ShellyAPP oder über my.shelly.cloud in Euren Account ein.

Über **Einstellungen → Benutzereinstellungen → Cloud-Aktivierungs-Schlüssel** könnt Ihr Euren einmaligen Schlüssel sowie den dazugehörigen Server abholen.  
 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/7/2/72ecb1ab48dda8fd944b943cb8c0be3431d06314.png)  
_Den Key solltet Ihr niemanden geben, da damit alle Eure Shellys verwaltet werden können. Solltet Ihr mal Euer Password in der ShellyCloud ändern, ändert sich auch der Key!_

Als Nächstes benötigt Ihr noch die ID von dem Gerät, welches Ihr Steuern wollt. Dazu navigiert Ihr zu diesem und findet unter **Einstellungen → Geräteinformationen** die **Geräte-ID**.

 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/c/0/c0dcadd18efd6ce09588490ef7a183275ad6b3b0.png)  
_Diese notiert/kopiert Ihr Euch ebenfalls._

Mit diesen Drei Informationen (API Key, Shelly-Server und GeräteID) könnt Ihr remote einen Shelly steuern.

Dazu benötigen wir die “Dann” Kondition mit der Logik Karte  
 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/6/e/6ead6e1c2937512cf7cfc5352cc0d32c5413c313.png)

Nun gilt es diese Karte mit Leben zu füllen. (In diesem Beispiel öffne ich ein Fenster mit einem Shelly 2.5 im „Roller Mode“)

> Methode: **Post**  
> URL: **[https://shelly-XX-eu.shelly.cloud/device/relay/roller/control](https://shelly-XX-eu.shelly.cloud/device/relay/roller/control)** (XX mit eurem Shellyserver austauschen)  
> Headers: **content-type:application/x-www-form-urlencoded** (damit geben wir dem Server mit, das wir jetzt Anfragen im angegebenen Format übertragen)  
> Body: **id=XXXXXXXX&direction=open&auth\_key=XXXXXXXXXXXXXXXXXXXXXXXXXXX…** Die ID ist Euere DeviceID und der auth\_Key der API Schlüssel

Wenn diese Kachel jetzt ausführt, sollte sich das Fenster, das Rollo oder die Jalousie öffnen. Zum Schließen sendet Ihr einfach “ **Close** ” und zum Anhalten “ **Stop** ” bzw. könnt Ihr mit **pos** statt **direction** auch eine Prozentangabe schicken “**pos=[0…100]**”

Solltet Ihr den Shelly zum Schalten von verschiedenen Lichtern nutzen, so ändert sich die API URL

> URL: [https://shelly-xx-eu.shelly.cloud/device/relay/control](https://shelly-xx-eu.shelly.cloud/device/relay/control)  
> Body: **channel=&turn=on&auth\_key=XXXXXXXXXXXXXXXXXX…**

Mit der Channel-ID sagt ihr dem Shelly, welchen Kanal er schalten soll (0 oder 1). Mit turn gibt Ihr dem Shelly mit ob er das Relay ein (on) oder aus (off) schalten soll. Wenn diese Grundprinzipien verstanden sind, ist es ein leichtes auch die anderen Shellys der Familie zu steuern.

Hier findet Ihr eine kleine Übersicht der einzelnen Shellys und der Möglichkeiten sie zu steuern:

> **[Communication | Shelly Technical Documentation](https://shelly-api-docs.shelly.cloud/cloud-control-api/communication/)**
>
> For calling a device you need the device\_id for that device. It is available

Solltet Ihr noch Fragen haben, dann gern hier rein.  
Den umgekehrten Weg Remote → Shelly werde ich in einem anderen Tutorial angehen.

---

<div class="post-metadata">

**Author:** ![schmucke](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/schmucke/32/79913_2.png) [@schmucke](https://community.homey.app/u/schmucke)\
**Post date:** [September 11, 2023, 11:38am UTC](https://community.homey.app/t/tutorial-shelly-remote-uber-cloud-api-mit-homey-steuern/89187/2 "2023-09-11T11:38:40Z")

</div>

Platzhalter