Skip to main content

getSensors

Beschreibung:
Ruft eine Liste aller Sensoren und deren Informationen für ein bestimmtes PowerDog-Gerät ab.
Diese Funktion gibt detaillierte Sensordaten zurück, darunter Typ, Name und Messbereich.

Endpunkt: /api
Methode: POST

Parameter:

  • apikey (string) – API-Schlüssel des Benutzers, aus getApiKey()
  • PowerDogID (number) – Eindeutige Kennung des PowerDog-Geräts, aus getPowerDogs()

Beispielanfrage:

{
    "action": "getSensors",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "PowerDogID": "36789"
}

Beispielantwort:

{
    "valid": 1,
    "sensors": {
        "onewire_1494659203": {
            "KEY": "onewire_1494659203",
            "Type": "Temperature",
            "Max": "100",
            "Name": "boilertemp",
            "id": "551929"
        },
        "adcsensor_1522075451": {
            "KEY": "adcsensor_1522075451",
            "Type": "Global_Radiation",
            "Max": "1200",
            "Name": "radiation",
            "id": "551931"
        }
    },
    "id": 36789
}

Beschreibung der Antwortparameter:

  • valid (number):
    Gibt an, ob die Anfrage erfolgreich war (1 = Erfolg, 0 = Fehler).

  • sensors (object):
    Ein Objekt, das eine Liste aller Sensoren enthält. Jeder Sensor hat eine eindeutige KEY-ID.

    • KEY (string):
      Eindeutige Kennung des Sensors.

    • Type (string):
      Typ des Sensors, z. B. Temperature, Voltage, Energy.

    • Max (string):
      Maximale Messkapazität des Sensors.

    • Name (string):
      Name des Sensors.

    • id (string):
      Interne ID des Sensors.

  • id (number):
    Eindeutige Kennung des PowerDog-Geräts, zu dem die Sensoren gehören.

Nähere Informationen zu Antwortformat und Fehlermeldungen:

Antwortformat und Fehler