POST /plants/graficas
Permite realizar una solicitud para obtener gráficos basados en datos de plantas solares según el proveedor seleccionado.
Parámetros de Consulta
- proveedor (requerido): ID único del proveedor de la planta.
Parámetros de JSON
/* GoodWe */ { "id": "b5e7ad84-679f-4b99-a238-912631598450", "date": "2024-11-11", // fecha en la que sacas el gráfico "range": "dia", // 2 dia 3 mes y 4 año "chartIndexId": "generación de energía y ingresos" // Depende del gráfico cambian los datos que se le pasan } /* GoodWe */ { "id": "b5e7ad84-679f-4b99-a238-912631598450", "date": "2024-11-21", // fecha en la que sacas el gráfico "chartIndexId": "potencia" // Depende del gráfico cambian los datos que se le pasan } /* SolarEdge */ { "id": "1851069", "dia": "DAY", // dia mes o año que quieres que te saque "fechaFin": "2024-11-19", // parametro opcional si no se le manda se le pasara la fecha de hoy a las 23:59:59 "fechaInicio": "2024-11-18" // parametro opcional si no se envia se recogera en DAY principio del dia actual Month dia 1 del mes actual o YEAR primer dia del año actual } /* Grafica de Victron Energy */ { "id": "98081", "interval": "15mins", // 15mins hours 2hours days weeks months years "type": "venus", // venus live_feed consumption solar_yield kwh generator generator-runtime custom forecast "fechaFin": "2024-11-25", // parametro opcional si no se le manda se le pasara la fecha de hoy a las 23:59:59 "fechaInicio": "2024-11-24" // parametro opcional si no se le manda se le pasara la fecha de hoy a las 00:00:00 } /* Grafica de Victron Energy overallstats */ { "id": "98081", "type": "venus", // venus live_feed consumption solar_yield kwh generator generator-runtime custom forecast "overallstats": true, // true or false }
Respuesta de Ejemplo
{ "status": true, "code": 200, "message": "200 - Solicitud exitosa", "data": { "consumption": [ { "date": "2024-11-18 00:00:00", "value": 117869 }, { "date": "2024-11-19 00:00:00", "value": 127128 } ], "totalConsumption": 244997, "solarProduction": [ { "date": "2024-11-18 00:00:00", "value": 60023 }, { "date": "2024-11-19 00:00:00", "value": 64201 } ], "totalProduction": 124224, "storagePower": [ { "nameplate": 9800, "serialNumber": "7E043EDB", "modelNumber": "LGC RESU 10", "telemetryCount": 1149, "telemetries": [ { "timeStamp": "2024-11-18 00:00:51", "power": 0, "batteryState": 10, "lifeTimeEnergyDischarged": 13491068, "lifeTimeEnergyCharged": 9357134, "batteryPercentageState": 11, "fullPackEnergyAvailable": 7920, "internalTemp": 27.4, "ACGridCharging": 0 } ] } ], "totalExport": 16259, "porcentajeExport": 13.088453116950024, "overview": { "lastUpdateTime": "2024-12-04 10:21:38", "lifeTimeData": { "energy": 94705520 }, "lastYearData": { "energy": 27781930 }, "lastDayData": { "energy": 16459 } } } }
Respuesta de Ejemplo
curl -X POST "https://app-energiasolarcanarias-backend.com/plants/graficas?proveedor=solaredge" \ -H "Authorization: Bearer tu_token_de_acceso" \ -H "Content-Type: application/json" \ -d '{ "id": "1851069", "proveedor": "SolarEdge", "dia": "DAY", "fechaInicio": "2024-11-18", "fechaFin": "2024-11-19" }'
Parámetros de JSON
- id: Identificador único de la planta (e.g., "1851069").
- proveedor: Nombre del proveedor (e.g., "SolarEdge").
- dia: Tipo de rango de tiempo ("QUARTER_OF_AN_HOUR","HOUR","DAY","WEEK", "MONTH", or "YEAR") por defecto DAY.
- fechaInicio: Fecha de inicio para los datos solicitados (formato: "YYYY-MM-DD").
- fechaFin: Fecha de finalización para los datos solicitados (formato: "YYYY-MM-DD").
- chartIndexId: Opcional, especifica el tipo de datos del gráfico (e.g., "generación de energía").
- range: Opcional, rango para proveedores específicos (e.g., "dia", "mes", "año").
- interval: Opcional, intervalo de tiempo para Victron Energy (e.g., "15mins", "hours", "2hours", "days", "weeks", "months", "years").
- type: Opcional, tipo de datos para Victron Energy (e.g., "venus", "live_feed", "consumption", "solar_yield", "kwh", "generator", "generator-runtime", "custom", "forecast").
- overallstats: true o false para mostrar el gráfico con las estadísticas generales