Exportação de Dados em Bruto para Excel

A exportação em bruto entrega as medições tal como registadas — qualquer janela temporal, qualquer resolução (de 5 minutos até um dia), sem estar limitada a dias inteiros — como um CSV que pode abrir diretamente no Excel ou no LibreOffice. Este guia percorre os quatro casos do dia a dia: a produção de um único parque, vários parques lado a lado, inversores individuais e strings individuais.

Enquanto a exportação por modelo foi concebida para scripts de relatórios automatizados e repetíveis, a exportação em bruto foi feita para análise manual: puxe uma janela para uma folha de cálculo, crie uma tabela dinâmica, faça um gráfico, e está feito.

Pré-requisitos

Conta Mirox com permissão para ler o parque que exporta
Token de API com o grupo de permissões Reporting — consulte Utilização de Tokens de API. (Numa sessão de navegador com sessão iniciada, o link partilhável funciona sem token.)

O Caminho Fácil: Copiar o Link da Interface

Nunca tem de construir um URL à mão. Abra Exportação de dados ▸ Dados em bruto, escolha os seus parques, métricas, janela e resolução — a página mostra em tempo real uma pré-visualização do URL da API que espelha exatamente a sua seleção, incluindo as escolhas de componentes. Copie-o, acrescente o cabeçalho com o token no curl (ou abra-o simplesmente no navegador) e tem o CSV.

Os exemplos abaixo mostram o aspeto desses URLs, para que os possa adaptar em scripts ou guardar variações como favoritos.

Os Modos de Valor

Os contadores de energia nos dados em bruto são cumulativos — só aumentam. O parâmetro value decide o que chega à sua folha de cálculo:

`value`	Significado	Use para
`plain` (predefinição)	O contador tal como registado, a acumular ao longo da janela de exportação	Verificações ao estilo de leitura de contador
`start_at_zero`	Cada série deslocada para começar em 0	Comparar curvas de crescimento
`use_delta`	A variação por intervalo — p. ex. a energia produzida em cada bloco de 15 minutos	Análise de produção — é normalmente o que quer no Excel

Receita 1: Produção de um Único Parque

Uma semana da produção de rede de um parque com resolução de 15 minutos, como energia por intervalo:

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

Um ano completo a 15 minutos funciona da mesma forma — defina start/end com um ano de intervalo (o seletor na aplicação tem as predefinições Este ano e Ano passado exatamente para isto). Essa é a maior janela por série que a exportação permite; para janelas de vários anos mude para step=1h ou 1d.

O catálogo de métricas em bruto (ids, nomes, unidades) está em GET /v1/metrics/raw; até 20 métricas por pedido, separadas por vírgulas.

Receita 2: Comparação Multi-Parque

Vários parques num único ficheiro, uma coluna por parque (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 (a predefinição) combina os parques numa única coluna por métrica — somada para energia/potência, calculada pela média para temperaturas e rácios.
portfolio=<uid> delimita a exportação a todos os parques de uma carteira sem os listar.
Uma exportação separada (split) está limitada a 50 colunas (métricas × parques).

Receita 3: Inversores Individuais

A exportação de componentes aprofunda os componentes de um parque. Os ids de métricas têm o prefixo comp_raw_ (catálogo: 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;...

Sem uma seleção components, a exportação pagina por todos os inversores do parque (page/limit, até 50 por página).
Para escolher inversores específicos, passe components=<id1>,<id2>,... — os ids aparecem no seletor de componentes da interface (e no URL que copia), ou na lista components da resposta da exportação.
component_type=gak funciona de forma idêntica para caixas combinadoras.
multi_component_agg=merge colapsa a seleção numa única coluna (soma para energia, média para tensões/temperaturas).

Receita 4: Strings Individuais

O mesmo endpoint com component_type=string — ideal para comparar uma string suspeita com as suas vizinhas:

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

A forma mais fácil de obter os ids das strings é o seletor na aplicação, no separador Dados em bruto (nível de detalhe String): selecione as strings e copie o URL pré-visualizado — já inclui a lista components.

Abrir o CSV no Excel

Separadores: as predefinições (; de campo, , decimal) abrem diretamente no Excel com configuração regional alemã. Para configurações regionais EUA/Reino Unido passe separator_csv=,&separator_decimal=. — os dois têm de ser diferentes.
Datas: os passos inferiores a um dia incluem a hora do dia; datetime_format aceita um padrão strftime (p. ex. %d.%m.%Y) se a sua configuração regional o exigir.
Codificação: os ficheiros são UTF-8; use Dados ▸ De Texto/CSV se os caracteres acentuados aparecerem errados.
Cabeçalhos localizados: language=de (ou es, fr, it, pt) traduz os nomes das colunas.
Tamanho: as respostas grandes são comprimidas com gzip na transmissão quando o cliente o aceita — daí o --compressed nos exemplos; os navegadores tratam disto automaticamente.

Limites

Limite	Valor
Métricas por pedido	20
Pontos de dados por série (nível parque)	180 000 — 5 anos com resolução de 15 minutos cabem
Amostras no total (nível parque)	1 800 000 (séries × pontos de dados por série)
Pontos de dados por série (nível componente)	36 000 — um ano completo com resolução de 15 minutos cabe
Colunas `split` por parque	50 (métricas × parques)
Componentes selecionados explicitamente	50
Colunas `split` de componentes	100 (métricas × componentes)

Um pedido acima do orçamento é rejeitado com 400 e uma mensagem que identifica o limite — aumente o passo, encurte a janela ou reduza a seleção. A referência completa encontra-se no Guia da API de Exportação de Métricas.

Funcionalidades Relacionadas

Gerador Externo de Relatórios — a contraparte da exportação por modelo: relatórios automatizados em Python
API de Exportação de Métricas — referência completa de parâmetros e limites para todos os caminhos de exportação
Utilização de Tokens de API — crie o token que os exemplos curl utilizam
MiroxQL — crie métricas derivadas para as exportações agregadas