Metering API

POST /v1/metering-points/{metering_point_id}/readings

15-Minuten-Messwerte einer Messstelle in einer einzigen Anfrage hochladen. Die Zeitstempel sind ISO 8601 in UTC und müssen auf einer Viertelstundengrenze liegen; die Werte sind Dezimalzahlen in kWh. Ein Messwert, der ein bereits vorhandenes Intervall in derselben Richtung trifft, überschreibt den gespeicherten Wert. Der Stapel wird als Ganzes verarbeitet — scheitert ein Messwert an der Validierung, wird nichts geschrieben, und die Antwort führt die Feldfehler auf. Über die API hochgeladene Messwerte sind Daten des Teilnehmers und dienen der Anzeige, dem Vergleich und der Planung. Sie ersetzen nicht die Lieferung des Messstellenbetreibers an OES, und granulare Zertifikate entstehen aus ihnen 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}/readings
X-Api-Key<token>

In: header

Path Parameters

metering_point_idstring

Kennung der Messstelle

readingsarray<ReadingInput>

Die hochzuladenden Messwerte. Der Stapel wird als Ganzes verarbeitet — scheitert ein Messwert an der Validierung, wird nichts geschrieben.

Items1 <= items

Response Body

curl -X POST "https://api.otark.com/v1/metering-points/mp_e4f8a2c6/readings" \  -H "Content-Type: application/json" \  -d '{    "readings": [      {        "interval_start": "2026-03-18T12:00:00Z",        "value": 4356.742,        "direction": "production",        "quality": "uploaded"      },      {        "interval_start": "2026-03-18T12:15:00Z",        "value": 4102.31,        "direction": "production",        "quality": "uploaded"      },      {        "interval_start": "2026-03-18T12:30:00Z",        "value": 3541.955,        "direction": "production",        "quality": "uploaded"      },      {        "interval_start": "2026-03-18T12:45:00Z",        "value": 4001.118,        "direction": "production",        "quality": "uploaded"      }    ]  }'

{
  "metering_point_id": "mp_e4f8a2c6",
  "accepted": 4,
  "replaced": 0
}

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