getStringYearData

Beschreibung:
Ruft die jährlichen Erzeugungsdaten eines bestimmten Wechselrichter-Strings für einen angegebenen Zeitraum ab.
Diese Funktion liefert Jahresverbrauchs- und Leistungswerte für einen bestimmten Wechselrichter-String.

Endpunkt: /api
Methode: POST

Parameter:

• apikey (string) – API-Schlüssel des Benutzers, aus getApiKey()
• SensorID (number) – Eindeutige Kennung des Sensors (Wechselrichter-ID), aus getInverters()
• StringNum (number) – String-ID (normalerweise 1-3), MMP-Tracker-ID, aus StringList in getInverters()
• year_from (number) – Startjahr der Abfrage (z. B. 2010)
• year_to (number) – Endjahr der Abfrage (z. B. aktuelles Jahr)

Beispielanfrage:

{
    "action": "getStringYearData",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "SensorID": "551902",
    "StringNum": "1",
    "year_from": "2022",
    "year_to": "2023"
}

Beispielantwort:

{
    "sensor_id": 551902,
    "string_num": 1,
    "valid": 1,
    "datasets": {
        "2022": {
            "WH": "3205440",
            "YEAR": "2022"
        },
        "2023": {
            "WH": "3066610",
            "YEAR": "2023"
        }
    }
}

Beschreibung der Antwortparameter:

• sensor_id (number):
  Eindeutige Kennung des Sensors, für den die Daten abgefragt wurden.

• string_num (number):
  Die Nummer des Photovoltaik-Strings.

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

• datasets (object):
  Enthält jährliche Erzeugungswerte für den angeforderten Zeitraum.
  Jeder Schlüssel repräsentiert ein Jahr (YYYY).

  • WH (string):
    Gesamtenergieerzeugung des Jahres in Wattstunden (Wh).

  • YEAR (string):
    Das Jahr der Messung.

Nähere Informationen zu Antwortformat und Fehlermeldungen:

Antwortformat und Fehler