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