# getStringYearData

**Beschreibung:**  
Ruft die jährlichen Erzeugungsdaten eines bestimmten Wechselrichter-Strings für einen angegebenen Zeitraum ab.  
Diese Funktion liefert Jahresverbrauchs- 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()`
- `year_from` (number) – Startjahr der Abfrage (z. B. 2010)
- `year_to` (number) – Endjahr der Abfrage (z. B. aktuelles Jahr)

#### Beispielanfrage:
```json
{
    "action": "getStringYearData",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "SensorID": "551902",
    "StringNum": "1",
    "year_from": "2022",
    "year_to": "2023"
}
```

#### Beispielantwort:
```json
{
    "sensor_id": 551902,
    "string_num": 1,
    "valid": 1,
    "datasets": {
        "2022": {
            "WH": "3205440",
            "YEAR": "2022"
        },
        "2023": {
            "WH": "3066610",
            "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 jährliche Erzeugungswerte für den angeforderten Zeitraum.  
  Jeder Schlüssel repräsentiert ein Jahr (`YYYY`).

  - **WH** (string):  
    Gesamtenergieerzeugung des Jahres in Wattstunden (Wh).

  - **YEAR** (string):  
    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)