====== Philips Hue API Benutzer einrichten - 09.07.2021 ======
Damit [[https://wiki.rocrail.net/doku.php?id=start-de/|RocRail]] per Programmierschnittstelle, der sogenannten API (application programming interface), auf die [[https://amzn.to/3AKve4P|Philips Hue  Bridge]] [[https://amzn.to/3AKve4P|{{fa>amazon?12}}]] zugreifen kann, muss hier ein Benutzer angelegt werden. \\ 
\\ 
Dieser muss über die API direkt eingerichtet werden. An sich ist das Ganze nicht schwer, jedoch meines Erachtens etwas umständlich auf der Hue-Seite beschrieben (Original-Seite [[https://developers.meethue.com/develop/get-started-2/]]). \\
======  ======
\\
\\ 
===== IP der Bridge =====
Für das weitere Vorgehen, benötigen wir die IP der Hue Bridge. Diese könnt Ihr entweder über Euren Router oder die HueApp auslesen.\\
\\ 
Um die IP über die App auszulesen, wechseln wir rechts unten auf **Einstellungen** / **Hue Bridges Aktiv: Philips hue** / **Philips hue**\\ 
\\
{{modelleisenbahn:hue27.jpg?200|}}
{{modelleisenbahn:hue28.jpg?200|}}


===== API aufrufen =====
Die API ruft Ihr über Euren Browser auf \\
<code>https://<Eure IP-Adresse>/debug/clip.html</code> 
\\
==== Anlegen eines Benutzers ====
\\ 
{{modelleisenbahn:hue-api-01.png?400|}} \\
\\
Hier tragt Ihr folgende Werte ein: \\

| ** Feld ** | ** Befehl ** | ** Erläuterung ** |
| URL: | /api/ | Aufruf der API |
| Message Body: | {"devicetype":"hue_app#rrla"} | Den devicetype und den Namen könnt Ihr frei vergeben. \\ "hue_app = frei gewählter Name der Verbindung" \\ "rrla = frei gewählter Benutzername" |

Vor dem Absenden, müsst Ihr an Eurer **Hue Bridge** den runden Button drück und dann in der API den Button **POST** \\
\\ 
Erhaltet Ihr unter **Command Response** die Meldung **link button not pressed** wurde der Button an der Bridge nicht gedrückt. Bitte nochmals wiederholen. \\
\\
{{modelleisenbahn:hue-api-02.png?400|}} \\
\\
Wurde der Benutzer erfolgreich erstellt sieht die Ausgabe unter **Command Response** wie folgt aus: \\
\\
{{modelleisenbahn:hue-api-03.png?400|}} \\
\\
Die Zeichenfolge ("0IVrrxxxxxxxxxxxxxxxxxxxxxxxxxxxxb4eZPJw"), ohne die Anführungszeichen, hinter dem **username** ist der Benutzer mit dem Ihr die Bridge nun ansprechen könnt. Diesen solltet Euch speichern und sicher verwahren, da wir diesen später für RocRail benötigen. Ihr solltet diesen auch niemals weitergeben, da mit diesem Benutzer jeder Eure Philips Hue Bridge steuern kann. \\
\\
Damit ist die Einrichtung des Benutzers abgeschlossen. Auf der Philips Hue API Seite sind noch verschiedene Testszenarien beschrieben, die wir hier aber nicht benötigen. \\
\\

----

===== Fazit =====
Im ersten Moment ist die API-Benutzung etwas gewöhnungsbedürftig, aber durchaus machbar. Mit der Einrichtung [[modelleisenbahn:philips-hue|Bridge]] und des Benutzers sind wir nun in der Lage, die [[https://amzn.to/3AOiV7t|Philips Hue]] [[https://amzn.to/3AOiV7t|{{fa>amazon?12}}]] in Rocrail als Zentrale einzurichten. \\
\\
Ich hoffe, ich konnte Euch mit den Anleitung weiterhelfen und würde mich über einen Kommentar freuen. \\
\\
Euer RoBa\\
\\
<WRAP center round rsbgruen 60%>
===Hinweis===
\\
Wenn Euch die Artikel gefallen und Ihr die Seite unterstützen möchtet, würden wir uns freuen, wenn Ihr die [[https://amzn.to/3hwyIjE|Philips Hue Lampen]] [[https://amzn.to/3AKve4P|{{fa>amazon?12}}]] über unseren Partnerlink erwerben würdet. \\
\\
</WRAP>

----


{{page>modelleisenbahn:modelleisenbahn#Philips_Hue}}

Anleitungen im [[https://wiki.rocrail.net/doku.php?id=german|RocRail Wiki]] \\ 
  * [[https://wiki.rocrail.net/doku.php?id=philips:hue-de|Philips HUE]] \\ 
  * [[https://wiki.rocrail.net/doku.php?id=philips:hue-conf-de|Philips HUE Konfiguration]] \\ 
  * [[https://wiki.rocrail.net/doku.php?id=philips:hue-sensors-de|Philips HUE Zubehör]] \\ 
  * [[https://wiki.rocrail.net/doku.php?id=weather-de#theme|RocRail - Wetter]] \\ 
  * [[https://wiki.rocrail.net/doku.php?id=actions-de|RocRail - Aktionen]] \\ 
 \\ 


{{page>impressum:ausschluss#Haftungsausschluss}}



~~DISCUSSION~~