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 und Basis-URL

Erstellen Sie einen Schlüssel unter Daten → API Tokens. Details dazu unter API-Schlüssel erstellen.

Nach der Erstellung finden Sie auf der Token-Detailseite zwei wichtige Werte:

API Token — Ihr Schlüssel für die Authentifizierung. Kopieren Sie ihn sofort — er wird nur einmal angezeigt.
Basis-URL — Ihre team-spezifische URL, z. B. https://energiedaten.at/api/v1/teams/mein-team

Schritt 2 — Zähler auflisten

Rufen Sie Ihre Zähler ab, um die Zähler-ID zu erhalten:

curl https://energiedaten.at/api/v1/teams/{TEAM}/meters \
  -H "Authorization: Bearer {TOKEN}"

Die Antwort enthält Ihre Zähler mit deren UUIDs:

{
  "data": [
    {
      "id": "9c3a5e8f-1b2d-4a6e-8f0c-3d5e7a9b1c2d",
      "metering_point": "AT0010000000000000001000000000001",
      "energy_direction": "consumption",
      "granularity": "quarter_hour",
      "status": "connected",
      "latest_data_at": "2026-04-05T08:15:00Z",
      "created_at": "2026-01-10T08:00:00Z"
    }
  ]
}

Kopieren Sie die id des gewünschten Zählers für den nächsten Schritt.

Schritt 3 — Messdaten abrufen

Ersetzen Sie {TEAM}, {TOKEN} und {METER_ID} mit Ihren Werten:

curl "https://energiedaten.at/api/v1/teams/{TEAM}/meters/{METER_ID}/data?from=2026-04-05T00:00:00Z&to=2026-04-05T01:00:00Z" \
  -H "Authorization: Bearer {TOKEN}"

Eine erfolgreiche Antwort sieht so aus:

{
  "data": [
    {
      "timestamp": "2026-04-05T00:00:00Z",
      "timestamp_end": "2026-04-05T00:15:00Z",
      "value": 0.285,
      "unit": "kWh",
      "obis_code": "1-1:1.8.0",
      "quality": 1
    },
    {
      "timestamp": "2026-04-05T00:15:00Z",
      "timestamp_end": "2026-04-05T00:30:00Z",
      "value": 0.312,
      "unit": "kWh",
      "obis_code": "1-1:1.8.0",
      "quality": 1
    }
  ],
  "meta": {
    "meter_id": "9c3a5e8f-1b2d-4a6e-8f0c-3d5e7a9b1c2d",
    "metering_point": "AT0010000000000000001000000000001",
    "granularity": "quarter_hour",
    "from": "2026-04-05T00:00:00Z",
    "to": "2026-04-05T01:00:00Z",
    "total_records": 4,
    "data_completeness": 1.0,
    "quality_breakdown": {
      "measured": 4,
      "estimated": 0,
      "unreliable": 0
    }
  }
}

Datenqualität: 1 = gemessen, 2 = geschätzt, 3 = unsicher. Filtern mit ?quality=measured.

Für die neuesten Messwerte

Ohne Zeitraum — die letzten 96 Werte (ein Tag in Viertelstundenwerten):

curl https://energiedaten.at/api/v1/teams/{TEAM}/meters/{METER_ID}/data/latest \
  -H "Authorization: Bearer {TOKEN}"

Nächste Schritte

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