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
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Messstelle
Die hochzuladenden Messwerte. Der Stapel wird als Ganzes verarbeitet — scheitert ein Messwert an der Validierung, wird nichts geschrieben.
1 <= itemsResponse 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"
}/metering-points/{metering_point_id} GET
Eine einzelne Messstelle über ihre Kennung abrufen. Erforderlicher Scope: metering:read
/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