getInverters

Beschreibung: Ruft eine Liste der Wechselrichter (Inverters) für das angegebene SmartDog-Gerät ab.
Endpunkt: /api
Methode: POST

Parameter:

• apikey (string) – API-Schlüssel des Benutzers
• PowerDogID (number) – Eindeutige Kennung des SmartDog-Geräts

Beispielanfrage:

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

Beispielantwort:

{
    "valid": 1,
    "inverters": {
        "B1_A2": {
            "BUS": 1,
            "ADDRESS": 2,
            "Manufactor": "sma",
            "Modulfield": "1",
            "Modulfield_Name": "Haus1",
            "Monitoring": "on",
            "Capacity": "3000",
            "SerialNo": "2000049568",
            "Type": "WR25-014",
            "Strings": "1",
            "desc": "SMA",
            "StringList": {
                "1": {
                    "STRING": 1,
                    "Capacity": "3000"
                }
            },
            "id": "551902"
        },
        "B8_A1": {
            "BUS": 8,
            "ADDRESS": 1,
            "Manufactor": "sma",
            "Modulfield": "2",
            "Modulfield_Name": "Garage",
            "Monitoring": "on",
            "Capacity": "2000",
            "SerialNo": "1930203053",
            "Type": "SB2.0",
            "Strings": "1",
            "desc": "SMA Bus8",
            "StringList": {
                "1": {
                    "STRING": 1,
                    "Capacity": "2000"
                }
            },
            "id": "551903"
        }
    },
    "id": 36789
}

Beschreibung der Antwortparameter:

• valid (number):
  Status der API-Anfrage. Ein Wert von 1 signalisiert, dass der Aufruf erfolgreich war.

• inverters (object):
  Ein Objekt, das die Wechselrichter (Inverters) enthält. Jeder Schlüssel in diesem Objekt (z. B. B1_A2, B8_A1) repräsentiert einen spezifischen Wechselrichter.

  Für jeden Wechselrichter gelten folgende Parameter:

  • BUS (number):
    Die Busnummer, die dem Wechselrichter zugeordnet ist.

  • ADDRESS (number):
    Die Adresse des Wechselrichters im jeweiligen Bus.

  • Manufactor (string):
    Der Hersteller des Wechselrichters (z. B. "sma").

  • Modulfield (string):
    Eine Kennzeichnung oder Identifikation des Modulfelds.

  • Modulfield_Name (string):
    Der Name des Modulfelds, beispielsweise "Haus1" oder "Garage".

  • Monitoring (string):
    Der Überwachungsstatus des Wechselrichters (z. B. "on").

  • Capacity (string):
    Die Kapazität des Wechselrichters, in Watt angegeben.

  • SerialNo (string):
    Die Seriennummer des Wechselrichters.

  • Type (string):
    Die Modellbezeichnung oder der Typ des Wechselrichters.

  • Strings (string):
    Die Anzahl der zugeordneten Strings (Photovoltaik-Stränge).

  • desc (string):
    Eine zusätzliche Beschreibung oder ein Hinweis zum Wechselrichter.

  • StringList (object):
    Ein Objekt, das detaillierte Informationen zu den einzelnen Strings enthält. Jeder Schlüssel repräsentiert eine String-Nummer.

    • STRING (number):
      Die Nummer des Strings.
    • Capacity (string):
      Die Kapazität des jeweiligen Strings in Watt.

  • id (string):
    Die eindeutige Kennung des Wechselrichters.

• id (number):
  Die eindeutige Kennung des übergeordneten Geräts (z. B. des SmartDog-Geräts), zu dem die Wechselrichter gehören.

Nähere Informationen zu Antwortformat und Fehlermeldungen:

Antwortformat und Fehler