# Geraete steuern

Mit Ihrem KliServ-IoT API-Key koennen Sie Geraeten steuern, die Sie auch in Dashboard steuern koennen.

Der API-Endpoint ist: https://my-kliserv-iot-instance.com/api/v1/device/set
Die HTTP-Methode ist: POST

Ihren API-Key geben Sie im Header im Feld: "Authorization" an.

Im Body muessen Sie ein JSON-Objekt folgender Struktur senden:

{"serialNumber":"","value":""}

Dabei ist "serialNumber" die Seriennummer des zu steuernden Geraetes und value, der Wert, auf welchen es gesetzt werden soll. Zu beachten ist, dass "value" ein serielisierter JSON-String sein muss! Beispiel:

{\"state\": \"off\"}

Der Server gibt ein JSON objekt zurueck, wobei der Parameter success true/false sein kann, je nachdem, ob der Request erfolgreich war. Wenn der Request nicht erfolgreich war, gibt es außerdem noch die Parameter type und msg, wobei type = danger ist und msg eine Beschreibung des Fehlers enthaelt.