# Daten auslesen

Mit Ihrem KliServ-IoT API-Key koennen Sie Daten von Geraeten auslesen, die Sie auch in Dashboard sehen koennen.

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

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

Als Parameter muessen die folgenden angegeben werden:

  1. serialNumber: Ist die Seriennummer des Geraetes, dessen Daten Sie auslesen moechten.
  2. filterProfile: Ist das FIlter-Profil, von welchem Zeitraum Sie die Daten auslesen moechten.
    Verfuegbare Profile sind:
    - lastHour -> Alle Daten der letzten Stunde.
    - past24hours -> Alle Daten der letzten 24 Stunden.
    - past48hours -> Alle Daten der letzten 48 Stunden.
    - custom -> Damit koennen Sie selbst einen Zeitraum ueber die Parameter fromTimeUTC und untilTimeUTC definieren.
    Nur noetig, wenn "filterProfile" = "custom":
  3. fromTimeUTC: Ist der UTC Zeitstempel, ab wann Daten ausgelesen werden sollen. Folgendes Format muss verwendet werden: ISO 8601
  4. untilTimeUTC: Ist der UTC Zeitstempel, bis wann Daten ausgelesen werden sollen. Folgendes Format muss verwendet werden: ISO 8601

Der Server gibt ein JSON objekt zurueck, wobei der Parameter success true/false sein kann, je nachdem, ob der Request erfolgreich war.
Der Parameter data beinhaltet die eigentlichen Daten, wobei die Parameter von Geraet zu geraet variieren, je nach dem, was das Geraet fuer Daten sendet.
In diesem Variablen Parameter befindet sich dann eine Liste mit den eigentlichen Daten. Dabei beinhaltet value den Wert und timeStamp den Zeitpunkt, zudem der Messwert bei KliServ-IoT eingegangen ist.

Response-Beispiel
{"success": true, "data": {"state": [{"value": "ON", "timeStamp": "2023-08-10T13:46:09.641032+00:00"}, {"value": "ON", "timeStamp": "2023-08-10T13:46:10.543324+00:00"}]}}