# getCounters

**Beschreibung:**  
Ruft eine Liste aller Zähler und deren Informationen für ein bestimmtes PowerDog-Gerät ab.  
Diese Funktion gibt detaillierte Informationen zu den angeschlossenen Energiezählern zurück.  

**Endpunkt:** `/api`  
**Methode:** `POST`  

#### Parameter:
- `apikey` (string) – API-Schlüssel des Benutzers, aus `getApiKey()`
- `PowerDogID` (number) – Eindeutige Kennung des PowerDog-Geräts, aus `getPowerDogs()`

#### Beispielanfrage:
```json
{
    "action": "getCounters",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "PowerDogID": "36789"
}
```

#### Beispielantwort:
```json
{
    "valid": 1,
    "counters": {
        "pv_global_1499321681": {
            "KEY": "pv_global_1499321681",
            "Type": "Energy",
            "Max": 5000,
            "Name": "PV",
            "Hardware": "pv_global",
            "Medium": "ELECTRIC",
            "id": "551904"
        },
        "buscounter_1579943663": {
            "KEY": "buscounter_1579943663",
            "Type": "Energy",
            "Max": "5000",
            "Name": "GRIDIN",
            "Hardware": "buscounter",
            "Medium": "ELECTRIC",
            "id": "551911"
        }
    },
    "id": 36789
}
```

#### Beschreibung der Antwortparameter:
- **valid** (number):  
  Gibt an, ob die Anfrage erfolgreich war (`1` = Erfolg, nicht vorhanden = Fehler).
  
- **counters** (object):  
  Ein Objekt, das eine Liste aller Zähler enthält. Jeder Zähler hat eine eindeutige **KEY**-ID.

  - **KEY** (string):  
    Eindeutige Kennung des Zählers.
  
  - **Type** (string):  
    Typ des Zählers, z. B. `Energy`.
  
  - **Max** (number):  
    Maximale Messkapazität des Zählers.
  
  - **Name** (string):  
    Name des Zählers.
  
  - **Hardware** (string):  
    Bezeichnung der Zählerhardware.
  
  - **Medium** (string):  
    Medium des Zählers (z. B. `ELECTRIC`, `MBUS_HEATMETER`).
  
  - **id** (string):  
    Interne ID des Zählers.

- **id** (number):  
  Eindeutige Kennung des PowerDog-Geräts, zu dem die Zähler gehören.