API di esportazione legacy

Questa pagina descrive i link di esportazione che esistevano prima del Metric Export. Sono legacy: vengono serviti senza modifiche, con gli stessi parametri, ID di metrica e colonne, e non vengono più ampliati.

Route

Tutti i percorsi seguono https://service.mirox.io/api. Un token API del gruppo Metric Export le legge tutte.

Che cosa è deprecato

Una route deprecata risponde ancora, ma può essere rimossa in una versione successiva, e il riferimento interattivo delle API la contrassegna come deprecata.

• La route da modello per un solo impianto sotto /v1/export/report/{park_uid}/data/template/…. Usa invece l'esportazione da modello; accetta gli stessi modelli.
• Le tre route POST che restituivano le esportazioni in JSON. La Metric Export API risponde in JSON con format=json.
• GET /v1/export/template/metrics, l'elenco degli ID di metrica legacy per l'editor dei modelli. Lo sostituisce il catalogo delle metriche.

Tutto il resto di questa pagina è legacy ma non deprecato.

Più impianti: unire o dividere

Tutte e quattro le esportazioni accettano i parametri park e portfolio separati da virgola. Quando sono indicati entrambi, gli impianti di ciascun portfolio vengono aggiunti agli impianti elencati.

multi_park_agg decide come vengono rappresentati più impianti. È disponibile nell'esportazione da modello, per ID di metrica e raw; l'esportazione per componente ha invece multi_component_agg.

Con un solo impianto le due opzioni sono identiche e il parametro viene ignorato.

Esportazione da modello

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"

Modelli di sistema legacy

Nell'app, questi cinque sono sostituiti dai loro successori nella scheda Template. I loro link continuano a rispondere come prima.

Report Technical v1 (ABCD12340001) contiene:

Metriche di serie temporali:

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

Metriche di configurazione del report:

• 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

Metriche calcolate (con MiroxQL):

• Analisi dell'irraggiamento (effettivo, utilizzo meteo, differenza sensore-meteo)
• Target di produzione (basati su meteo, basati su sensore, effettivi, corretti)
• Performance ratio (meteo, sensore, effettivo, corretto)
• Resa specifica (Wh/W)
• Analisi delle perdite (perdite non compensabili)

Modelli del Metric Export su questa route

L'esportazione da modello accetta anche l'ID di un modello del Metric Export, ad esempio CAFE1000CAFE. In tal caso risponde con il Metric Export di quel modello: i parametri di calendario scelgono il periodo, resolution sceglie il passo e il file segue le convenzioni del Metric Export. Non ha le colonne "Days in Month" o "Calendar Week", e gli errori rispondono con un code. Senza resolution vale il passo del modello.

La route deprecata per un solo impianto non accetta un modello di questo tipo e risponde 400 con il link da usare.

Output CSV

I file hanno una riga di intestazione con nomi e unità delle metriche. La struttura segue la risoluzione:

• Giornaliera — una riga per giorno.
• Settimanale — una colonna "Date" in formato settimana ISO e una colonna "Calendar Week" con il numero della settimana.
• Mensile — una colonna "Days in Month" per la normalizzazione.

I valori vengono aggregati per giorno e poi riepilogati: energia e ore vengono sommate, tutto il resto viene mediato. Un giorno è un giorno UTC. Un valore mancante viene scritto come 0.

Esportazione per ID di metrica

GET /v1/export/metrics/query esporta un insieme di ID di metrica legacy senza un modello, con i parametri di periodo e il formato CSV dell'esportazione da modello.

Esportazione di serie temporali raw

GET /v1/export/raw/query restituisce serie temporali raw a livello di impianto. GET /v1/metrics/raw elenca ogni ID raw con nome, unità, categoria e l'operatore che applica tra le serie (sum, avg, min o 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
...

L'energia è in Wh e l'ora è in UTC.

Esportazione raw per componente

GET /v1/export/raw/component/query esporta le serie temporali raw di singoli componenti — inverter, quadri di campo o singole stringhe — di esattamente un impianto. Gli ID delle metriche dei componenti portano il prefisso comp_raw_ e sono elencati, per tipo di componente, su GET /v1/metrics/components.

Limiti

Entrambe le esportazioni raw rifiutano con 400 qualsiasi richiesta più grande:

Le risposte oltre circa 1 MB vengono compresse quando la richiesta contiene Accept-Encoding: gzip.

ID di metrica legacy

Le metriche giornaliere dell'esportazione da modello e per ID di metrica. Ognuna può essere aggregata a valori settimanali, mensili, trimestrali o annuali. La colonna della formula mostra in forma semplificata come viene derivato un valore. La metrica che risponde per ciascun ID nel Metric Export si trova nella mappatura degli ID.

Metriche di produzione di energia

Metriche di spegnimento e perdita

Metriche di irraggiamento

Metriche meteo

Metriche ambientali

Metriche di disponibilità

Metriche delle batterie

Metriche di report

Gli ID raw e dei componenti sono elencati da GET /v1/metrics/raw e GET /v1/metrics/components, e nella mappatura degli ID.

Comportamenti noti che restano come sono

I numeri delle esportazioni legacy vengono mantenuti come sono, così che una cartella di lavoro mostri domani ciò che mostrava ieri. Questo comprende tre letture che il Metric Export esegue in modo diverso:

Correzioni

Due gruppi di colonne dell'esportazione di serie temporali raw erano vuoti e ora contengono valori. Una cartella di lavoro che li legge mostra numeri dove prima mostrava celle vuote.

Informazioni sull'impianto

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

Restituisce i dati di base di un impianto in JSON: nome, tipo e descrizione, posizione e fuso orario, potenza di picco, organizzazione e portfolio, indirizzo e date di messa in servizio. Un esempio si trova nel Generatore di report esterni.

Eventi

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

Le colonne sono Event ID, Start Date, End Date, Duration (hours), Type, Creator, Description e Priority. La data di fine di un evento ancora aperto è Ongoing. Una priorità di 1000 o più contrassegna un evento importante.

Funzionalità correlate

• Metric Export API — l'esportazione attuale
• Migrare al Metric Export — che cosa cambia e la mappatura degli ID
• Formule MiroxQL — l'API delle formule dietro le colonne calcolate
• Generatore di report esterni — informazioni sull'impianto ed eventi in un esempio Python
• Token API — il token Metric Export