getStringData

Beschreibung: Ruft Daten eines spezifischen Strings (Photovoltaik-Daten) für einen Sensor im angegebenen Zeitraum ab.
Endpunkt: /api
Methode: POST

Parameter:

• apikey (string) – API-Schlüssel des Benutzers
• SensorID (number) – Eindeutige Kennung des Sensors
• StringNum (number) – Nummer des Strings (Photovoltaik-String)
• UTC_TIMESTAMP_FROM (number) – Startzeitpunkt im UTC-Timestamp-Format
• UTC_TIMESTAMP_TO (number) – Endzeitpunkt im UTC-Timestamp-Format

Beispielanfrage:

{
  "action": "getStringData",
  "apikey": "6641d282073d76b625987af5141d3e2a",
  "SensorID": "551902",
  "StringNum": "1",
  "UTC_TIMESTAMP_FROM": "1739867939",
  "UTC_TIMESTAMP_TO": "1739877939"
}

Beispielantwort:

{
    "sensor_id": 551902,
    "string_num": 1,
    "valid": 1,
    "test": "bcde",
    "datasets": {
        "1739868002.000000": {
            "PAC": "844",
            "PDC": "907",
            "UDC": "358",
            "TEMPERATURE": "29",
            "TIMESTAMP_LOCAL": 1739871602,
            "TIMESTAMP_UTC": "1739868002.000000"
        },
        "1739868302.000000": {
            "PAC": "878",
            "PDC": "944",
            "UDC": "359",
            "TEMPERATURE": "31",
            "TIMESTAMP_LOCAL": 1739871902,
            "TIMESTAMP_UTC": "1739868302.000000"
        }
    }
}

Beschreibung der Antwortparameter:

• sensor_id (number):
  Die eindeutige ID des Sensors, für den die Daten abgefragt wurden.

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

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

• test (string):
  Testwert oder Debug-Information (kann variieren).

• datasets (object):
  Ein Objekt mit den Zeitstempeln als Schlüssel, das Messwerte zu jedem Zeitpunkt enthält.

  • PAC (string):
    Wechselstromleistung (AC) in Watt.

  • PDC (string):
    Gleichstromleistung (DC) in Watt.

  • UDC (string):
    Gleichspannung in Volt.

  • TEMPERATURE (string):
    Temperatur in Grad Celsius.

  • TIMESTAMP_LOCAL (number):
    Zeitstempel in der lokalen Zeitzone.

  • TIMESTAMP_UTC (string):
    Zeitstempel im UTC-Format.

Nähere Informationen zu Antwortformat und Fehlermeldungen:

Antwortformat und Fehler