Rohdaten-Export für Excel

Der Roh-Export liefert die Messwerte wie aufgezeichnet — beliebiger Zeitraum, beliebige Auflösung (5 Minuten bis zu einem Tag), nicht an ganze Tage gebunden — als CSV-Datei, die Sie direkt in Excel oder LibreOffice öffnen können. Diese Anleitung führt durch die vier alltäglichen Fälle: die Produktion eines einzelnen Parks, mehrere Parks nebeneinander, einzelne Wechselrichter und einzelne Strings.

Während der Template-Export für automatisierte, wiederholbare Reporting-Skripte gebaut ist, ist der Roh-Export für die manuelle Analyse gemacht: einen Zeitraum in eine Tabellenkalkulation ziehen, pivotieren, visualisieren, fertig.

Voraussetzungen

Mirox-Konto mit der Berechtigung, den zu exportierenden Park zu lesen
API-Token mit der Berechtigungsgruppe Reporting — siehe API-Token-Nutzung. (In einer angemeldeten Browser-Sitzung funktioniert der teilbare Link auch ohne Token.)

Der einfache Weg: Link aus der Oberfläche kopieren

Sie müssen niemals eine URL von Hand zusammensetzen. Öffnen Sie Datenexport ▸ Rohdaten und wählen Sie Ihre Parks, Metriken, den Zeitraum und die Auflösung — die Seite zeigt eine live aktualisierte API-URL-Vorschau, die exakt Ihre Auswahl widerspiegelt, einschließlich der Komponentenauswahl. Kopieren Sie sie, ergänzen Sie in curl Ihren Token-Header (oder öffnen Sie sie einfach im Browser), und Sie haben die CSV-Datei.

Die folgenden Beispiele zeigen, wie diese URLs aussehen, damit Sie sie in Skripten anpassen oder Varianten als Lesezeichen speichern können.

Die Wertmodi

Energiezähler in den Rohdaten sind kumulativ — sie wachsen immer nur an. Der Parameter value entscheidet, was in Ihrer Tabellenkalkulation landet:

`value`	Bedeutung	Geeignet für
`plain` (Standard)	Der Zähler wie aufgezeichnet, über den Exportzeitraum anwachsend	Kontrollen im Stil einer Zählerablesung
`start_at_zero`	Jede Reihe so verschoben, dass sie bei 0 beginnt	Vergleich von Wachstumskurven
`use_delta`	Die Änderung je Intervall — z. B. die in jedem 15-Minuten-Fenster produzierte Energie	Produktionsanalyse — das ist es, was Sie in Excel in der Regel möchten

Rezept 1: Produktion eines einzelnen Parks

Eine Woche Netzeinspeisung eines Parks in 15-Minuten-Auflösung, als Energie je Intervall:

curl --compressed "https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o production_week.csv

Date;Grid Production (Wh)
2026-07-01 00:00;0,00
2026-07-01 00:15;0,00
2026-07-01 06:15;1250,50
...

Ein ganzes Jahr in 15 Minuten funktioniert genauso — setzen Sie start/end ein Jahr auseinander (der Auswahldialog in der App bietet genau dafür die Voreinstellungen Dieses Jahr und Letztes Jahr). Das ist das größte Fenster je Reihe, das der Export zulässt; für mehrjährige Zeiträume wechseln Sie zu step=1h oder 1d.

Der Katalog der Rohmetriken (IDs, Namen, Einheiten) liegt unter GET /v1/metrics/raw; bis zu 20 Metriken je Anfrage, kommagetrennt.

Rezept 2: Multi-Park-Vergleich

Mehrere Parks in einer Datei, eine Spalte je Park (multi_park_agg=split):

curl --compressed "https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456,DEF456ABC123&start=2026-07-01T00:00:00Z&end=2026-08-01T00:00:00Z&step=1h&value=use_delta&multi_park_agg=split" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o parks_compare.csv

Date;Sunnyside - Grid Production (Wh);Riverbend - Grid Production (Wh)
2026-07-01 00:00;0,00;0,00
...

multi_park_agg=merge (der Standard) fasst die Parks stattdessen zu einer Spalte je Metrik zusammen — summiert bei Energie/Leistung, gemittelt bei Temperaturen und Verhältniswerten.
portfolio=<uid> grenzt auf alle Parks eines Portfolios ein, ohne sie einzeln aufzuführen.
Ein aufgeteilter Export ist auf 50 Spalten begrenzt (Metriken × Parks).

Rezept 3: Einzelne Wechselrichter

Der Komponenten-Export bohrt in die Komponenten eines Parks hinein. Metrik-IDs tragen das Präfix comp_raw_ (Katalog: GET /v1/metrics/components?component_type=inverter):

curl --compressed "https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_inverter_energy_ac&park=ABC123DEF456&component_type=inverter&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o inverters.csv

Date;WR 01.01 - Inverter Production (Wh);WR 01.02 - Inverter Production (Wh);...
2026-07-01 06:15;620,25;618,75;...

Ohne eine components-Auswahl blättert der Export durch alle Wechselrichter des Parks (page/limit, bis zu 50 je Seite).
Um bestimmte Wechselrichter auszuwählen, übergeben Sie components=<id1>,<id2>,... — die IDs erscheinen im Komponenten-Auswahldialog der Oberfläche (und in dessen kopierter URL) oder in der components-Liste der Export-Antwort.
component_type=gak funktioniert identisch für Generatoranschlusskästen.
multi_component_agg=merge fasst die Auswahl zu einer Spalte zusammen (Summe bei Energie, Mittelwert bei Spannungen/Temperaturen).

Rezept 4: Einzelne Strings

Derselbe Endpunkt mit component_type=string — ideal, um einen auffälligen String gegen seine Nachbarn zu prüfen:

curl --compressed "https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_string_energy&park=ABC123DEF456&component_type=string&components=1084279778457255938&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o string.csv

Der einfachste Weg zu den String-IDs ist der Auswahldialog in der App auf dem Tab „Rohdaten" (Detailebene String): Wählen Sie die Strings aus und kopieren Sie die angezeigte Vorschau-URL — sie enthält die components-Liste bereits.

Die CSV-Datei in Excel öffnen

Trennzeichen: Die Standardwerte (; als Feld-, , als Dezimaltrennzeichen) öffnen sich direkt in Excel mit deutschem Gebietsschema. Für US-/UK-Gebietsschemata übergeben Sie separator_csv=,&separator_decimal=. — beide müssen sich unterscheiden.
Datumsangaben: Bei Schrittweiten unterhalb eines Tages ist die Uhrzeit enthalten; datetime_format akzeptiert ein strftime-Muster (z. B. %d.%m.%Y), falls Ihr Gebietsschema es benötigt.
Kodierung: Die Dateien sind UTF-8; verwenden Sie Daten ▸ Aus Text/CSV, falls Umlaute falsch dargestellt werden.
Lokalisierte Spaltenüberschriften: language=de (oder es, fr, it, pt) übersetzt die Spaltennamen.
Größe: Große Antworten werden auf dem Übertragungsweg gzip-komprimiert, wenn der Client dies akzeptiert — daher --compressed in den Beispielen; Browser erledigen das automatisch.

Grenzwerte

Grenzwert	Wert
Metriken je Anfrage	20
Datenpunkte je Reihe (Park-Ebene)	180.000 — fünf Jahre in 15-Minuten-Auflösung passen hinein
Messpunkte insgesamt (Park-Ebene)	1.800.000 (Reihen × Datenpunkte je Reihe)
Datenpunkte je Reihe (Komponenten-Ebene)	36.000 — ein ganzes Jahr in 15-Minuten-Auflösung passt hinein
`split`-Spalten je Park-Export	50 (Metriken × Parks)
Explizit ausgewählte Komponenten	50
`split`-Spalten im Komponenten-Export	100 (Metriken × Komponenten)

Eine Anfrage über dem Budget wird mit 400 und einer Meldung abgelehnt, die den Grenzwert benennt — erhöhen Sie die Schrittweite, verkürzen Sie den Zeitraum oder reduzieren Sie die Auswahl. Die vollständige Referenz finden Sie im Leitfaden zur Metrik-Export-API.