Metering API
Lastgangdaten programmatisch hochladen und abfragen — die Schnittstelle als Ersatz für den manuellen CSV-Upload.
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/v1Alle 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
| Konvention | Regel |
|---|---|
| Zeitstempel | ISO 8601 in UTC (2026-03-18T12:00:00Z) — wie auf jedem Kanal, siehe Granularität & Zeitstempel |
| Messwerte | Dezimalzahl 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) |
| Paginierung | Listen nehmen limit (1–100, Vorgabe 10) und einen Cursor after entgegen; die Antwort führt pagination mit has_more und next_cursor |
| Fehler | application/problem+json nach RFC 9457, mit Feldfehlern bei Validierungsfehlern |
| Ratenbegrenzung | 300 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
| Ressource | Zweck |
|---|---|
| Messstellen | Die Messstellen des Teilnehmers einsehen — angelegt im Anlagen-Onboarding, über die API nur lesbar |
| Messwerte | 15-Minuten-Werte je Messstelle als JSON hochladen und mit Zeitfenster abfragen |
| CSV-Import | Eine 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.
/assets GET
Vorherige Seite
/metering-points GET
Die Messstellen des angemeldeten Teilnehmers auflisten. Messstellen entstehen im Anlagen-Onboarding oder beim Einrichten eines Lastgangs — die API legt sie nicht an. Erforderlicher Scope: metering:read
Zuletzt aktualisiert am