# 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:
```json
{
  "action": "getStringDayData",
  "apikey": "6641d282073d76b625987af5141d3e2a",
  "SensorID": "551902",
  "StringNum": "1",
  "day_from": "1",
  "day_to": "12",
  "month": "1",
  "year": "2024"
}
```

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