Editing Archiv:Lichtsteuerung (section)

=== API ===

Es existiert eine (noch nicht finale) JSON-API. In einigen Fällen wird auch Textausgabe unterstützt.  Für Textformat <tt>.txt</tt> an Anfragen anhängen (oder <tt>curl -H 'Accept: text/plain'</tt> benutzen), für JSON entsprechend <tt>.json</tt> bzw. <tt>application/json</tt>.

<tt>/get</tt> liefert derzeit auch PNGs. Sie entsprechen den in der Übersicht verwendeten.

{| class="wikitable"
! Request
! Parameter
! Aktion
|-
| POST <tt>/action</tt>
| '''action'''=<nowiki>on|off|toggle</nowiki>, '''device'''=''lampe''
| Schaltet ''lampe'' an / aus, gibt den neuen Status als JSON zurück
|-
| POST <tt>/action</tt>
| '''action'''=shortcut, '''shortcut'''=''aktion''
| Führt ''aktion'' aus (z.B. shutdown oder amps on)
|-
| POST <tt>/action</tt>
| '''action'''=preset, '''preset'''=''preset''
| Schaltet die Lampen wie in ''preset'' angegeben
|-
| GET <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe''
| Gibt alle gespeicherten [[Blinkencontrol]]-Animationen (und falls bekannt die aktuell laufende) als JSON zurück
|-
| POST <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe'', '''raw_string'''=''animation''
| Setzt ''animation'' auf ''lampe''. Format ist <tt>delay1,red1,green1,blue1 delay2,red2,green2,blue2</tt> <nowiki>[...]</nowiki>, siehe [[Blinkencontrol]]
|-
| POST <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe'', '''raw_string'''=''animation'', '''name'''=''name''
| Setzt ''animation'' auf ''lampe'' und speichert sie unter ''name'' ab, so dass sie im Webinterface ausgewählt werden kann.
|-
| POST <tt>/ajax/blinkencontrol</tt>
| '''device'''=''lampe'', '''name'''=''name'', '''delete'''=1
| Löscht die Animation ''name'' von ''lampe''
|-
| GET <tt>/ajax/charwrite</tt>
|
| Gibt die möglichen Modi zurück
|-
| POST <tt>/ajax/charwrite</tt>
| '''device'''=''anzeige'', '''text'''=''modus''<nowiki>|</nowiki>''text''
| Setzt modus oder freitext für ''anzeige''
|-
| GET <tt>/ajax/menu</tt>
|
| Gibt die vorhandenen Shortcuts und Presets (siehe <tt>/action</tt>) zurück
|-
| GET <tt>/get/''device''</tt>
|
| Gibt den aktuellen Status von ''device'' zurück
|-
| GET <tt>/list/all</tt>
|
| Gibt alle Geräte mit Koordinaten, Status, Beschreibung etc. zurück
|-
| GET <tt>/space_api</tt>
|
| Hackerspacestatus für die [http://spaceapi.net/ spaceAPI]
|-
|}