API-Schnelleinstieg

Mit der energiedaten.at API rufen Sie Messdaten Ihrer Zähler programmatisch ab. Dieser Einstieg zeigt den schnellsten Weg zu Ihrem ersten erfolgreichen API-Aufruf.

Schritt 1 — API-Schlüssel erstellen

Erstellen Sie einen Schlüssel unter Profil → API Tokens oder direkt am Zähler. Details dazu unter API-Schlüssel erstellen.

Notieren Sie sich den Schlüssel — er wird nur einmal angezeigt.

Schritt 2 — Zähler-ID kopieren

Öffnen Sie Zähler → [Zähler wählen] und kopieren Sie die Zählpunktnummer (33-stellige ID, beginnt mit AT00...).

Schritt 3 — Ersten API-Aufruf machen

Ersetzen Sie {IHR_SCHLUESSEL} und {ZAEHLER_ID} mit Ihren Werten:

curl https://energiedaten.at/api/v1/meters/{ZAEHLER_ID}/measurements \
  -H "Authorization: Bearer {IHR_SCHLUESSEL}" \
  -H "Accept: application/json"

Eine erfolgreiche Antwort sieht so aus:

{
  "data": [
    {
      "timestamp": "2025-03-16T08:00:00+01:00",
      "value_kwh": 0.285,
      "unit": "kWh",
      "quality": "measured"
    },
    {
      "timestamp": "2025-03-16T08:15:00+01:00",
      "value_kwh": 0.312,
      "unit": "kWh",
      "quality": "measured"
    }
  ],
  "meta": {
    "meter_id": "AT0010000000000000001000000000001",
    "from": "2025-03-16T08:00:00+01:00",
    "to": "2025-03-16T09:00:00+01:00",
    "count": 2
  }
}

Nächste Schritte

Die vollständige API-Referenz — alle Endpunkte, Parameter und Antwortformate — finden Sie in der API-Dokumentation.

Für automatische Push-Zustellung ohne polling empfehlen wir Webhooks oder MQTT.