POST /v1/metering-points/{metering_point_id}/imports
Eine CSV-Datei mit Messwerten für eine Messstelle hochladen. Das Dateiformat — Spalten, zulässige Einheiten und Wertregeln eingeschlossen — folgt der Spezifikation der Lastgangdateien: semikolongetrennt, mit Kopfzeile, ein 15-Minuten-Intervall je Zeile, eine Messstelle je Datei. Die Verarbeitung läuft asynchron — die Antwort liefert den Import im Status pending; das Ergebnis fragen Sie über den Endpunkt zum Importstatus ab. Eine Datei wird vollständig importiert oder gar nicht. Erforderlicher Scope: metering:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Messstelle
Die CSV-Datei (semikolongetrennt, mit Kopfzeile; im Zweifel UTF-8)
Response Body
curl -X POST "https://api.otark.com/v1/metering-points/mp_e4f8a2c6/imports" \ -F file="string"{
"id": "imp_5b9d1c3a",
"metering_point_id": "mp_e4f8a2c6",
"filename": "wea-nord-1-2026-03-18.csv",
"status": "pending",
"rows_total": null,
"rows_imported": null,
"created_at": "2026-03-19T06:30:00Z",
"completed_at": null
}{
"type": "https://api.otark.com/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/metering-points/mp_e4f8a2c6/readings",
"errors": [
{
"field": "readings.2.interval_start",
"code": "not_quarter_hour",
"message": "interval_start must be on a quarter-hour boundary (UTC), received '2026-03-18T12:07:00Z'"
}
]
}{
"type": "https://api.otark.com/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: metering:write. Please create a new API key with the required scopes."
}{
"type": "https://api.otark.com/errors/metering_point_not_found",
"title": "Messstelle nicht gefunden",
"status": 404,
"instance": "/v1/metering-points/mp_e4f8a2c6"
}/metering-points/{metering_point_id}/readings GET
Die Messwerte einer Messstelle in einem Zeitfenster auflisten, aufsteigend nach interval_start sortiert. Alle Zeitstempel sind ISO 8601 in UTC; die Werte sind Dezimalzahlen in kWh. Erforderlicher Scope: metering:read
/imports/{import_id} GET
Einen CSV-Import samt Verarbeitungsstatus abrufen. completed heißt, dass alle Zeilen geschrieben wurden; failed heißt, dass keine Zeile geschrieben wurde und errors die Gründe aufführt. Erforderlicher Scope: metering:read