Legacy-Export-API

Diese Seite beschreibt die Export-Links, die es vor dem Metric Export gab. Sie sind Legacy: Sie werden unverändert bedient, mit denselben Parametern, Metrik-IDs und Spalten, und sie werden nicht mehr erweitert.

Routen

Alle Pfade folgen auf https://service.mirox.io/api. Ein API-Token der Gruppe Metric Export liest sie alle.

Was veraltet ist

Eine veraltete Route antwortet weiterhin, kann aber in einer späteren Version entfernt werden, und die interaktive API-Referenz kennzeichnet sie als veraltet („deprecated“).

• Die Vorlagen-Route für eine einzelne Anlage unter /v1/export/report/{park_uid}/data/template/…. Nutzen Sie stattdessen den Vorlagen-Export; er nimmt dieselben Vorlagen.
• Die drei POST-Routen, die die Exporte als JSON beantwortet haben. Die Metric-Export-API antwortet mit format=json als JSON.
• GET /v1/export/template/metrics, die Liste der Legacy-Metrik-IDs für den Vorlagen-Editor. Der Metrikkatalog ersetzt sie.

Alles andere auf dieser Seite ist Legacy, aber nicht veraltet.

Mehrere Anlagen: Zusammenfassen oder Aufteilen

Alle vier Exporte akzeptieren kommagetrennte Parameter park und portfolio. Werden beide angegeben, kommen die Anlagen jedes Portfolios zu den aufgeführten Anlagen hinzu.

multi_park_agg bestimmt, wie mehrere Anlagen dargestellt werden. Der Parameter steht beim Vorlagen-, beim Metrik-ID- und beim Rohdaten-Export zur Verfügung; der Komponenten-Export hat stattdessen multi_component_agg.

Bei einer einzelnen Anlage sind beide identisch, und der Parameter wird ignoriert.

Vorlagen-Export

GET /v1/export/metrics/template/{template_uid}

curl "https://service.mirox.io/api/v1/export/metrics/template/ABCD12340001?park=ABC123DEF456&resolution=monthly" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Legacy-Systemvorlagen

In der App sind diese fünf auf dem Tab Vorlagen durch ihre Nachfolger ersetzt. Ihre Links antworten weiter wie bisher.

Report Technical v1 (ABCD12340001) enthält:

Zeitreihen-Metriken:

1. Energy Production (kWh) - energy_grid_daily
2. Energy Radiation Total (kWh) - energy_radiation_daily
3. GTI Sensor (kWh/m²) - gti_sensor_daily
4. GTI Weather (kWh/m²) - gti_weather_daily
5. Sunhours (h) - sunhours_daily
6. Availability Inverter (%) - availability_inverter
7. Availability Energy (%) - availability_energy
8. Availability Data (%) - availability_data
9. Availability Sensor (%) - availability_sensor
10. Energy Shutdown by Grid (kWh) - energy_shutdown_grid_daily
11. Energy Shutdown by External (kWh) - energy_shutdown_external_daily

Metriken der Berichtskonfiguration:

• Energy Report (kWh) - energy_report
• GTI Report Incident (kWh/m²) - gti_report
• GTI Report Effective (kWh/m²) - gti_report_eff
• PR Report Target (%) - pr_report

Berechnete Metriken (mit MiroxQL):

• Einstrahlungsanalyse (Ist, Wetternutzung, Differenz Sensor–Wetter)
• Produktionsziele (wetterbasiert, sensorbasiert, Ist, korrigiert)
• Performance Ratios (Wetter, Sensor, Ist, korrigiert)
• Spezifischer Ertrag (Wh/W)
• Verlustanalyse (nicht kompensierbare Verluste)

Vorlagen des Metric Export auf dieser Route

Der Vorlagen-Export akzeptiert auch die ID einer Vorlage des Metric Export, zum Beispiel CAFE1000CAFE. Er beantwortet dann den Metric Export dieser Vorlage: Die Kalenderparameter wählen den Zeitraum, resolution wählt die Schrittweite, und die Datei folgt den Konventionen des Metric Export. Sie hat keine Spalte „Days in Month“ oder „Calendar Week“, und Fehler werden mit einem code beantwortet. Ohne resolution gilt die Schrittweite der Vorlage.

Die veraltete Route für eine einzelne Anlage akzeptiert eine solche Vorlage nicht und antwortet mit 400 und dem Link, der zu verwenden ist.

CSV-Ausgabe

Die Dateien tragen eine Kopfzeile mit Metriknamen und Einheiten. Die Struktur folgt der Auflösung:

• Täglich — eine Zeile je Tag.
• Wöchentlich — eine Spalte „Date“ im ISO-Wochenformat und eine Spalte „Calendar Week“ mit der Wochennummer.
• Monatlich — eine Spalte „Days in Month“ zur Normalisierung.

Werte werden je Tag aggregiert und danach verdichtet: Energie und Stunden werden summiert, alles andere wird gemittelt. Ein Tag ist ein UTC-Tag. Ein fehlender Wert wird als 0 geschrieben.

Metrik-ID-Export

GET /v1/export/metrics/query exportiert eine Menge von Legacy-Metrik-IDs ohne Vorlage, mit den Zeitraum-Parametern und dem CSV-Format des Vorlagen-Exports.

Rohdaten-Zeitreihen-Export

GET /v1/export/raw/query liefert Rohdaten-Zeitreihen auf Anlagenebene. GET /v1/metrics/raw listet jede Rohdaten-ID mit Name, Einheit, Kategorie und dem Operator, den sie über die Reihen anwendet (sum, avg, min oder max).

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 06:15;1250,50
...

Energie ist in Wh, und die Zeit ist in UTC.

Komponenten-Rohdaten-Export

GET /v1/export/raw/component/query exportiert die Rohdaten-Zeitreihen einzelner Komponenten — Wechselrichter, Generatoranschlusskästen oder einzelne Strings — genau einer Anlage. Komponenten-Metrik-IDs tragen das Präfix comp_raw_ und werden, je Komponententyp, unter GET /v1/metrics/components gelistet.

Grenzen

Beide Rohdaten-Exporte lehnen alles Größere mit 400 ab:

Antworten über etwa 1 MB werden komprimiert, wenn die Anfrage Accept-Encoding: gzip enthält.

Legacy-Metrik-IDs

Die Tagesmetriken des Vorlagen- und des Metrik-ID-Exports. Jede lässt sich zu Wochen-, Monats-, Quartals- oder Jahreswerten aggregieren. Die Spalte Formel zeigt in vereinfachter Form, wie ein Wert abgeleitet wird. Die Metrik, die im Metric Export für die jeweilige ID antwortet, steht in der ID-Zuordnung.

Energieproduktions-Metriken

Abschaltungs- und Verlust-Metriken

Einstrahlungs-Metriken

Wetter-Metriken

Umwelt-Metriken

Verfügbarkeits-Metriken

Batterie-Metriken

Berichts-Metriken

Die Rohdaten- und Komponenten-IDs werden von GET /v1/metrics/raw und GET /v1/metrics/components gelistet und stehen in der ID-Zuordnung.

Bekanntes Verhalten, das bleibt, wie es ist

Die Zahlen der Legacy-Exporte bleiben, wie sie sind, damit eine Arbeitsmappe morgen zeigt, was sie gestern gezeigt hat. Dazu gehören drei Lesarten, die der Metric Export anders handhabt:

Korrekturen

Zwei Gruppen von Spalten des Rohdaten-Zeitreihen-Exports waren leer und tragen jetzt Werte. Eine Arbeitsmappe, die sie liest, zeigt Zahlen, wo sie leere Zellen gezeigt hat.

Anlageninformationen

GET /v1/export/report/{park_uid}/info

Beantwortet die Stammdaten einer Anlage als JSON: Name, Typ und Beschreibung, Standort und Zeitzone, Spitzenleistung, Organisation und Portfolio, Adresse und Inbetriebnahmedaten. Ein Beispiel steht im Externen Berichtsgenerator.

Ereignisse

GET /v1/export/report/{park_uid}/events.csv

Die Spalten sind Event ID, Start Date, End Date, Duration (hours), Type, Creator, Description und Priority. Das Enddatum eines noch offenen Ereignisses ist Ongoing. Eine Priorität von 1000 oder mehr kennzeichnet ein wichtiges Ereignis.

Verwandte Funktionen

• Metric-Export-API — der aktuelle Export
• Umstieg auf den Metric Export — was sich ändert, und die ID-Zuordnung
• MiroxQL-Formeln — die Formel-API hinter den berechneten Spalten
• Externer Berichtsgenerator — Anlageninformationen und Ereignisse in einem Python-Beispiel
• API-Tokens — das Token Metric Export