Metering API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/metering-points/{metering_point_id}/imports
X-Api-Key<token>

In: header

Path Parameters

metering_point_idstring

Kennung der Messstelle

filestring

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"
}