getStringMonthData

Beschreibung:
Ruft die monatlichen Erzeugungsdaten eines bestimmten Wechselrichter-Strings für einen angegebenen Zeitraum ab.
Diese Funktion liefert monatliche Verbrauchs- 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()
• month_from (number) – Startmonat der Abfrage (1-12)
• month_to (number) – Endmonat der Abfrage (1-12)
• year (number) – Angefragtes Jahr als Ganzzahl

Beispielanfrage:

{
    "action": "getStringMonthData",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "SensorID": "551902",
    "StringNum": "1",
    "month_from": "1",
    "month_to": "12",
    "year": "2023"
}

Beispielantwort:

{
    "sensor_id": 551902,
    "string_num": 1,
    "valid": 1,
    "datasets": {
        "2023-01": {
            "WH": "55147",
            "MONTH": "01",
            "YEAR": 2023
        },
        "2023-02": {
            "WH": "146404",
            "MONTH": "02",
            "YEAR": 2023
        },
        "2023-03": {
            "WH": "233747",
            "MONTH": "03",
            "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 monatliche Erzeugungswerte für den angeforderten Zeitraum.
  Jeder Schlüssel repräsentiert ein Monat (YYYY-MM).

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

  • MONTH (string):
    Der Monat der Messung.

  • YEAR (number):
    Das Jahr der Messung.

Nähere Informationen zu Antwortformat und Fehlermeldungen:

Antwortformat und Fehler