# 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:
```json
{
  "action": "getStringData",
  "apikey": "6641d282073d76b625987af5141d3e2a",
  "SensorID": "551902",
  "StringNum": "1",
  "UTC_TIMESTAMP_FROM": "1739867939",
  "UTC_TIMESTAMP_TO": "1739877939"
}
```

#### Beispielantwort:
```json
{
    "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](https://anleitung.smart-dog.eu/books/api-dokumentation/chapter/antwortformat-und-fehler)