getStringDayData

Beschreibung:
Ruft die Tageserzeugungsdaten eines spezifischen Strings für einen Sensor über einen angegebenen Zeitraum ab.
Diese Funktion liefert tägliche 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()
• day_from (number) – Starttag der Abfrage (1-31)
• day_to (number) – Endtag der Abfrage (1-31)
• month (number) – Angefragter Monat als Ganzzahl (1-12)
• year (number) – Angefragtes Jahr als Ganzzahl

Beispielanfrage:

{
  "action": "getStringDayData",
  "apikey": "6641d282073d76b625987af5141d3e2a",
  "SensorID": "551902",
  "StringNum": "1",
  "day_from": "1",
  "day_to": "12",
  "month": "1",
  "year": "2024"
}

Beispielantwort:

{
    "sensor_id": 551902,
    "string_num": 1,
    "valid": 1,
    "datasets": {
        "2024-1-01": {
            "WH": "4160",
            "PAC_MAX": "1189",
            "DAY": "01",
            "MONTH": 1,
            "YEAR": 2024
        },
        "2024-1-02": {
            "WH": "348",
            "PAC_MAX": "173",
            "DAY": "02",
            "MONTH": 1,
            "YEAR": 2024
        },
        "2024-1-03": {
            "WH": "2204",
            "PAC_MAX": "897",
            "DAY": "03",
            "MONTH": 1,
            "YEAR": 2024
        }
    }
}

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 Tageswerte für den angeforderten Zeitraum.
  Jeder Schlüssel repräsentiert ein Datum (YYYY-MM-DD).

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

  • PAC_MAX (string):
    Maximale Wechselstromleistung (AC) des Tages in Watt.

  • DAY (string):
    Der Tag innerhalb des abgefragten Zeitraums.

  • MONTH (number):
    Der Monat der Messung.

  • YEAR (number):
    Das Jahr der Messung.

Nähere Informationen zu Antwortformat und Fehlermeldungen:

Antwortformat und Fehler