# getInverters

**Beschreibung:** Ruft eine Liste der Wechselrichter (Inverters) für das angegebene SmartDog-Gerät ab.  
**Endpunkt:** `/api`  
**Methode:** `POST`  

#### Parameter:
- `apikey` (string) – API-Schlüssel des Benutzers
- `PowerDogID` (number) – Eindeutige Kennung des SmartDog-Geräts

#### Beispielanfrage:
```json
{
    "action": "getInverters",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "PowerDogID": "36789"
}
```

#### Beispielantwort:
```json
{
    "valid": 1,
    "inverters": {
        "B1_A2": {
            "BUS": 1,
            "ADDRESS": 2,
            "Manufactor": "sma",
            "Modulfield": "1",
            "Modulfield_Name": "Haus1",
            "Monitoring": "on",
            "Capacity": "3000",
            "SerialNo": "2000049568",
            "Type": "WR25-014",
            "Strings": "1",
            "desc": "SMA",
            "StringList": {
                "1": {
                    "STRING": 1,
                    "Capacity": "3000"
                }
            },
            "id": "551902"
        },
        "B8_A1": {
            "BUS": 8,
            "ADDRESS": 1,
            "Manufactor": "sma",
            "Modulfield": "2",
            "Modulfield_Name": "Garage",
            "Monitoring": "on",
            "Capacity": "2000",
            "SerialNo": "1930203053",
            "Type": "SB2.0",
            "Strings": "1",
            "desc": "SMA Bus8",
            "StringList": {
                "1": {
                    "STRING": 1,
                    "Capacity": "2000"
                }
            },
            "id": "551903"
        }
    },
    "id": 36789
}
```

#### Beschreibung der Antwortparameter:

- **valid** (number):  
  Status der API-Anfrage. Ein Wert von `1` signalisiert, dass der Aufruf erfolgreich war.

- **inverters** (object):  
  Ein Objekt, das die Wechselrichter (Inverters) enthält. Jeder Schlüssel in diesem Objekt (z. B. `B1_A2`, `B8_A1`) repräsentiert einen spezifischen Wechselrichter.

  Für jeden Wechselrichter gelten folgende Parameter:
  - **BUS** (number):  
    Die Busnummer, die dem Wechselrichter zugeordnet ist.
  
  - **ADDRESS** (number):  
    Die Adresse des Wechselrichters im jeweiligen Bus.
  
  - **Manufactor** (string):  
    Der Hersteller des Wechselrichters (z. B. "sma").
  
  - **Modulfield** (string):  
    Eine Kennzeichnung oder Identifikation des Modulfelds.
  
  - **Modulfield_Name** (string):  
    Der Name des Modulfelds, beispielsweise "Haus1" oder "Garage".
  
  - **Monitoring** (string):  
    Der Überwachungsstatus des Wechselrichters (z. B. "on").
  
  - **Capacity** (string):  
    Die Kapazität des Wechselrichters, in Watt angegeben.
  
  - **SerialNo** (string):  
    Die Seriennummer des Wechselrichters.
  
  - **Type** (string):  
    Die Modellbezeichnung oder der Typ des Wechselrichters.
  
  - **Strings** (string):  
    Die Anzahl der zugeordneten Strings (Photovoltaik-Stränge).
  
  - **desc** (string):  
    Eine zusätzliche Beschreibung oder ein Hinweis zum Wechselrichter.
  
  - **StringList** (object):  
    Ein Objekt, das detaillierte Informationen zu den einzelnen Strings enthält. Jeder Schlüssel repräsentiert eine String-Nummer.
    - **STRING** (number):  
      Die Nummer des Strings.
    - **Capacity** (string):  
      Die Kapazität des jeweiligen Strings in Watt.
  
  - **id** (string):  
    Die eindeutige Kennung des Wechselrichters.

- **id** (number):  
  Die eindeutige Kennung des übergeordneten Geräts (z. B. des SmartDog-Geräts), zu dem die Wechselrichter gehören.
 
#### Nähere Informationen zu Antwortformat und Fehlermeldungen:
[Antwortformat und Fehler](https://anleitung.smart-dog.eu/books/api-dokumentation/chapter/antwortformat-und-fehler)