Skip to main content

getCounters

Beschreibung:
Ruft eine Liste aller Zähler und deren Informationen für ein bestimmtes PowerDog-Gerät ab.
Diese Funktion gibt detaillierte Informationen zu den angeschlossenen Energiezählern zurück.

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": "getCounters",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "PowerDogID": "36789"
}

Beispielantwort:

{
    "valid": 1,
    "counters": {
        "pv_global_1499321681": {
            "KEY": "pv_global_1499321681",
            "Type": "Energy",
            "Max": 5000,
            "Name": "PV",
            "Hardware": "pv_global",
            "Medium": "ELECTRIC",
            "id": "551904"
        },
        "buscounter_1579943663": {
            "KEY": "buscounter_1579943663",
            "Type": "Energy",
            "Max": "5000",
            "Name": "GRIDIN",
            "Hardware": "buscounter",
            "Medium": "ELECTRIC",
            "id": "551911"
        }
    },
    "id": 36789
}

Beschreibung der Antwortparameter:

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

  • counters (object):
    Ein Objekt, das eine Liste aller Zähler enthält. Jeder Zähler hat eine eindeutige KEY-ID.

    • KEY (string):
      Eindeutige Kennung des Zählers.

    • Type (string):
      Typ des Zählers, z. B. Energy.

    • Max (number):
      Maximale Messkapazität des Zählers.

    • Name (string):
      Name des Zählers.

    • Hardware (string):
      Bezeichnung der Zählerhardware.

    • Medium (string):
      Medium des Zählers (z. B. ELECTRIC, MBUS_HEATMETER).

    • id (string):
      Interne ID des Zählers.

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