Metering API

Metering API

Lastgangdaten programmatisch hochladen und abfragen — die Schnittstelle als Ersatz für den manuellen CSV-Upload.

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.

Die Metering API ist der programmatische Weg, Lastgangdaten auf die Otark-Plattform zu bringen — als Ersatz für den manuellen CSV-Upload im Format der Seite Lastgangdateien. Teilnehmer laden 15-Minuten-Messwerte zu ihren Messstellen hoch und fragen sie ab — zur Anzeige, zum Vergleich und zur Planung im eigenen Konto: Verkäufer die Erzeugungsdaten ihrer Anlagen, Käufer ihren Verbrauchs-Lastgang. Die Messstellen selbst entstehen im Anlagen-Onboarding — die API liest sie nur.

Basis-URL

https://api.otark.com/v1

Alle Anfragen laufen über HTTPS. Antworten sind JSON; der CSV-Import nimmt multipart/form-data entgegen.

Authentifizierung

Alle Anfragen tragen den Header X-Api-Key:

curl -X GET "https://api.otark.com/v1/metering-points" \
  -H "X-Api-Key: IHR_API_KEY"

Wie die Authentifizierung plattformweit funktioniert und wo die Schlüssel der übrigen APIs entstehen, steht unter Authentifizierung.

API-Schlüssel erstellen Sie in den Kontoeinstellungen auf app.otark.com. Jeder Schlüssel trägt Scopes: metering:read für Lesezugriffe, metering:write für das Hochladen.

Konventionen

KonventionRegel
ZeitstempelISO 8601 in UTC (2026-03-18T12:00:00Z) — wie auf jedem Kanal, siehe Granularität & Zeitstempel
MesswerteDezimalzahl in kWh, je 15-Minuten-Intervall auf Viertelstundengrenze — gilt für die JSON-Endpunkte; die CSV-Datei trägt die Einheit je Zeile mit (Lastgangdateien)
PaginierungListen nehmen limit (1–100, Vorgabe 10) und einen Cursor after entgegen; die Antwort führt pagination mit has_more und next_cursor
Fehlerapplication/problem+json nach RFC 9457, mit Feldfehlern bei Validierungsfehlern
Ratenbegrenzung300 Anfragen je 60-Sekunden-Fenster, plattformweit gleich; die Antwort führt X-RateLimit-Limit, -Remaining und -Reset mit, bei Überschreitung 429 Too Many Requests

Ressourcen

RessourceZweck
MessstellenDie Messstellen des Teilnehmers einsehen — angelegt im Anlagen-Onboarding, über die API nur lesbar
Messwerte15-Minuten-Werte je Messstelle als JSON hochladen und mit Zeitfenster abfragen
CSV-ImportEine CSV-Datei im Format der Seite Lastgangdateien hochladen und den Importstatus abfragen

Abgrenzung: keine Ausstellungsgrundlage

Was über die Metering API eingeht, sind Daten des Teilnehmers. Sie dienen der Anzeige, dem Vergleich und der Planung. Granulare Zertifikate entstehen ausschließlich aus den HKN des Erzeugungsmonats und den finalen Messdaten des Messstellenbetreibers, die OES als Energieserviceanbieter auf Vollmacht direkt vom MSB erhält oder die der Verkäufer unter Zusatzvereinbarung unverändert an OES weiterleitet (Messdatenwege). Diesen Weg ersetzt die Metering API nicht, und sie ist auch nicht der Kanal dieser Weiterleitung.

Support

Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den Support.

Zuletzt aktualisiert am