Export de données brutes pour Excel

L'export brut livre les mesures telles qu'enregistrées — n'importe quelle fenêtre temporelle, n'importe quelle résolution (de 5 minutes à une journée), sans être limité à des journées entières — sous forme de CSV que vous pouvez ouvrir directement dans Excel ou LibreOffice. Ce guide parcourt les quatre cas quotidiens : la production d'un seul parc, plusieurs parcs côte à côte, des onduleurs individuels et des strings uniques.

Alors que l'export par modèle est conçu pour des scripts de reporting automatisés et reproductibles, l'export brut est fait pour l'analyse manuelle : extrayez une fenêtre dans un tableur, croisez-la, tracez-la, terminé.

Prérequis

Compte Mirox avec la permission de lire le parc que vous exportez
Jeton d'API avec le groupe de permissions Reporting — voir Utilisation des jetons d'API. (Dans un navigateur connecté, le lien partageable fonctionne sans jeton.)

La voie facile : copier le lien depuis l'interface

Vous n'avez jamais à construire une URL à la main. Ouvrez Export de données ▸ Données brutes, choisissez vos parcs, vos métriques, votre fenêtre et votre résolution — la page affiche un aperçu d'URL d'API en direct qui reflète exactement votre sélection, y compris les choix de composants. Copiez-le, ajoutez votre en-tête de jeton dans curl (ou ouvrez-le simplement dans le navigateur), et vous avez le CSV.

Les exemples ci-dessous montrent à quoi ressemblent ces URL, afin que vous puissiez les adapter dans des scripts ou en mettre des variantes en favoris.

Les modes de valeur

Les compteurs d'énergie dans les données brutes sont cumulatifs — ils ne font qu'augmenter. Le paramètre value décide de ce qui atterrit dans votre tableur :

`value`	Signification	À utiliser pour
`plain` (par défaut)	Le compteur tel qu'enregistré, s'accumulant sur la fenêtre d'export	Vérifications de type relevé de compteur
`start_at_zero`	Chaque série décalée pour démarrer à 0	Comparer des courbes de croissance
`use_delta`	La variation par intervalle — par ex. l'énergie produite dans chaque créneau de 15 minutes	Analyse de production — c'est généralement ce que vous voulez dans Excel

Recette 1 : production d'un seul parc

Une semaine de production réseau d'un parc à une résolution de 15 minutes, en énergie par intervalle :

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
...

Une année complète à 15 minutes fonctionne de la même manière — définissez start/end à un an d'écart (le sélecteur intégré à l'application propose les préréglages Cette année et Année dernière exactement pour cela). C'est la plus grande fenêtre par série que l'export autorise ; pour des fenêtres de plusieurs années, passez à step=1h ou 1d.

Le catalogue des métriques brutes (identifiants, noms, unités) est disponible via GET /v1/metrics/raw ; jusqu'à 20 métriques par requête, séparées par des virgules.

Recette 2 : comparaison multi-parcs

Plusieurs parcs dans un seul fichier, une colonne par parc (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 (la valeur par défaut) combine au contraire les parcs en une seule colonne par métrique — sommée pour l'énergie/la puissance, moyennée pour les températures et les ratios.
portfolio=<uid> délimite l'export à tous les parcs d'un portefeuille sans les lister.
Un export séparé est plafonné à 50 colonnes (métriques × parcs).

Recette 3 : onduleurs individuels

L'export de composants descend dans les composants d'un seul parc. Les identifiants de métriques portent le préfixe comp_raw_ (catalogue : 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;...

Sans sélection components, l'export parcourt page par page tous les onduleurs du parc (page/limit, jusqu'à 50 par page).
Pour en choisir certains, passez components=<id1>,<id2>,... — les identifiants apparaissent dans le sélecteur de composants de l'interface (et dans l'URL qu'il fait copier), ou dans la liste components de la réponse d'export.
component_type=gak fonctionne de manière identique pour les boîtes de jonction (GAK).
multi_component_agg=merge regroupe la sélection en une seule colonne (somme pour l'énergie, moyenne pour les tensions/températures).

Recette 4 : strings uniques

Même endpoint avec component_type=string — idéal pour vérifier un string suspect par rapport à ses voisins :

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

Le moyen le plus simple d'obtenir les identifiants de strings est le sélecteur intégré à l'application sur l'onglet Données brutes (niveau de détail String) : sélectionnez les strings, puis copiez l'URL prévisualisée — elle porte déjà la liste components.

Ouvrir le CSV dans Excel

Séparateurs : les valeurs par défaut (; pour les champs, , pour les décimales) s'ouvrent directement dans un Excel en locale allemande. Pour les locales US/UK, passez separator_csv=,&separator_decimal=. — les deux doivent être différents.
Dates : les pas infra-journaliers incluent l'heure de la journée ; datetime_format accepte un motif strftime (par ex. %d.%m.%Y) si votre locale l'exige.
Encodage : les fichiers sont en UTF-8 ; utilisez Données ▸ À partir d'un fichier texte/CSV si les caractères accentués s'affichent mal.
En-têtes localisés : language=de (ou es, fr, it, pt) traduit les noms de colonnes.
Taille : les réponses volumineuses sont compressées en gzip sur le réseau lorsque le client l'accepte — d'où --compressed dans les exemples ; les navigateurs gèrent cela automatiquement.

Limites

Limite	Valeur
Métriques par requête	20
Points de données par série (niveau parc)	180 000 — 5 ans à une résolution de 15 minutes tiennent
Échantillons au total (niveau parc)	1 800 000 (séries × points de données par série)
Points de données par série (niveau composant)	36 000 — une année complète à une résolution de 15 minutes tient
Colonnes `split` par parc	50 (métriques × parcs)
Composants sélectionnés explicitement	50
Colonnes `split` par composant	100 (métriques × composants)

Une requête dépassant le budget est rejetée avec un 400 et un message nommant la limite — augmentez le pas, raccourcissez la fenêtre ou réduisez la sélection. La référence complète se trouve dans le guide de l'API d'export de métriques.

Fonctionnalités associées

Générateur de rapports externes — le pendant côté export par modèle : reporting Python automatisé
API d'export de métriques — référence complète des paramètres et des limites pour tous les chemins d'export
Utilisation des jetons d'API — créez le jeton utilisé par les exemples curl
MiroxQL — construisez des métriques dérivées pour les exports agrégés