API de exportación heredada

Esta página describe los enlaces de exportación que existían antes de Metric Export. Son heredados: se sirven sin cambios, con los mismos parámetros, ids de métrica y columnas, y ya no se amplían.

Rutas

Todas las rutas siguen a https://service.mirox.io/api. Un token de API del grupo Metric Export las lee todas.

Qué está obsoleto

Una ruta obsoleta sigue respondiendo, pero puede retirarse en una versión posterior, y la referencia interactiva de la API la marca como obsoleta.

• La ruta de plantilla para una sola planta bajo /v1/export/report/{park_uid}/data/template/…. Usa en su lugar la exportación por plantilla; acepta las mismas plantillas.
• Las tres rutas POST que respondían las exportaciones como JSON. La API de Metric Export responde JSON con format=json.
• GET /v1/export/template/metrics, la lista de ids de métricas heredadas para el editor de plantillas. El catálogo de métricas la sustituye.

Todo lo demás de esta página es heredado, pero no obsoleto.

Varias plantas: combinar o separar

Las cuatro exportaciones aceptan los parámetros park y portfolio separados por comas. Cuando se indican ambos, las plantas de cada portfolio se añaden a las plantas listadas.

multi_park_agg decide cómo se representan varias plantas. Está disponible en las exportaciones por plantilla, por id de métrica y bruta; la exportación por componente tiene en su lugar multi_component_agg.

Con una única planta ambas son idénticas y el parámetro se ignora.

Exportación por plantilla

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"

Plantillas del sistema heredadas

En la aplicación, estas cinco se sustituyen por sus sucesoras en la pestaña Plantillas. Sus enlaces siguen respondiendo como antes.

Report Technical v1 (ABCD12340001) contiene:

Métricas de series temporales:

1. Producción de energía (kWh) - energy_grid_daily
2. Energía de radiación total (kWh) - energy_radiation_daily
3. Sensor GTI (kWh/m²) - gti_sensor_daily
4. GTI meteorológico (kWh/m²) - gti_weather_daily
5. Horas de sol (h) - sunhours_daily
6. Disponibilidad de inversor (%) - availability_inverter
7. Disponibilidad de energía (%) - availability_energy
8. Disponibilidad de datos (%) - availability_data
9. Disponibilidad de sensor (%) - availability_sensor
10. Energía de parada por red (kWh) - energy_shutdown_grid_daily
11. Energía de parada por control externo (kWh) - energy_shutdown_external_daily

Métricas de configuración de informe:

• Energía de informe (kWh) - energy_report
• GTI incidente de informe (kWh/m²) - gti_report
• GTI efectivo de informe (kWh/m²) - gti_report_eff
• PR objetivo de informe (%) - pr_report

Métricas calculadas (mediante MiroxQL):

• Análisis de irradiancia (real, uso meteorológico, diferencia sensor-meteorología)
• Objetivos de producción (basados en meteorología, basados en sensor, real, corregido)
• Performance ratios (meteorología, sensor, real, corregido)
• Rendimiento específico (Wh/W)
• Análisis de pérdidas (pérdidas no compensables)

Plantillas de Metric Export en esta ruta

La exportación por plantilla acepta también el id de una plantilla de Metric Export, por ejemplo CAFE1000CAFE. En ese caso responde la exportación de Metric Export de esa plantilla: los parámetros de calendario seleccionan el periodo, resolution selecciona el paso, y el archivo sigue las convenciones de Metric Export. No tiene columna «Days in Month» ni «Calendar Week», y los errores se responden con un code. Sin resolution, se aplica el paso de la plantilla.

La ruta obsoleta para una sola planta no acepta una plantilla así y responde 400 con el enlace que hay que usar.

Salida CSV

Los archivos llevan una fila de encabezado con los nombres de las métricas y las unidades. La estructura sigue la resolución:

• Diaria: una fila por día.
• Semanal: una columna «Date» en formato de semana ISO y una columna «Calendar Week» con el número de semana.
• Mensual: una columna «Days in Month» para la normalización.

Los valores se agregan por día y después se acumulan: la energía y las horas se suman, todo lo demás se promedia. Un día es un día UTC. Un valor ausente se escribe como 0.

Exportación por id de métrica

GET /v1/export/metrics/query exporta un conjunto de ids de métricas heredadas sin plantilla, con los parámetros de periodo y el formato CSV de la exportación por plantilla.

Exportación de series temporales brutas

GET /v1/export/raw/query devuelve series temporales brutas a nivel de planta. GET /v1/metrics/raw lista cada id bruto con su nombre, unidad, categoría y el operador que aplica entre series (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
...

La energía está en Wh, y la hora está en UTC.

Exportación bruta por componente

GET /v1/export/raw/component/query exporta las series temporales brutas de componentes individuales —inversores, cajas de conexión o strings individuales— de exactamente una planta. Los ids de métrica de componente llevan el prefijo comp_raw_ y se listan, por tipo de componente, en GET /v1/metrics/components.

Límites

Ambas exportaciones brutas rechazan con 400 cualquier solicitud mayor:

Las respuestas de más de 1 MB aproximadamente se comprimen cuando la solicitud lleva Accept-Encoding: gzip.

Ids de métricas heredadas

Las métricas diarias de las exportaciones por plantilla y por id de métrica. Cada una puede agregarse a valores semanales, mensuales, trimestrales o anuales. La columna de fórmula muestra de forma simplificada cómo se deriva un valor. La métrica que responde por cada id en Metric Export está en la correspondencia de ids.

Métricas de producción de energía

Métricas de parada y pérdida

Métricas de irradiancia

Métricas meteorológicas

Métricas ambientales

Métricas de disponibilidad

Métricas de batería

Métricas de informe

Los ids brutos y de componente los listan GET /v1/metrics/raw y GET /v1/metrics/components, y están en la correspondencia de ids.

Comportamiento conocido que se queda como está

Las cifras de las exportaciones heredadas se mantienen como están, para que un libro de Excel muestre mañana lo que mostraba ayer. Esto incluye tres lecturas que Metric Export hace de otra forma:

Correcciones

Dos grupos de columnas de la exportación de series temporales brutas estaban vacíos y ahora llevan valores. Un libro de Excel que las lee muestra cifras donde antes mostraba celdas vacías.

Información de la planta

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

Responde los datos maestros de una planta como JSON: nombre, tipo y descripción, ubicación y zona horaria, potencia pico, organización y portfolio, dirección y fechas de puesta en servicio. Hay un ejemplo en el Generador de informes externos.

Eventos

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

Las columnas son Event ID, Start Date, End Date, Duration (hours), Type, Creator, Description y Priority. La fecha de fin de un evento que sigue abierto es Ongoing. Una prioridad de 1000 o más marca un evento importante.

Funciones relacionadas

• API de Metric Export: la exportación actual
• Migrar a Metric Export: qué cambia, y la correspondencia de ids
• Fórmulas MiroxQL: la API de fórmulas que hay detrás de las columnas calculadas
• Generador de informes externos: información de la planta y eventos en un ejemplo en Python
• Tokens de API: el token Metric Export