Energetická zoznámka — API

SScloud poskytuje REST API pre prácu s energetickou zoznámkou — zariadenia, kategórie, výpočty spotreby a odporúčania.

Autentifikácia

API vyžaduje Bearer token (Laravel Sanctum).

Authorization: Bearer {your-api-token}

Endpointy

Zoznam zariadení

GET /api/v1/energy-audit

Vráti všetky zariadenia používateľa v energetickej zoznámke vrátane výpočtov a summary.

Odpoveď:

{
  "success": true,
  "data": {
    "devices": [
      {
        "id": 1,
        "name": "Bojler v kúpeľni",
        "category": "boiler",
        "category_label": "Bojler / Ohrievač vody",
        "power_rating_w": 2000,
        "daily_hours": 3,
        "quantity": 1,
        "is_always_on": false,
        "standby_power_w": 0,
        "seasonality": { "1": 1.5, "2": 1.4, ... },
        "notes": null,
        "calculations": {
          "daily_kwh": 6,
          "monthly_kwh": 182.5,
          "yearly_kwh": 2190,
          "yearly_cost_eur": 438
        },
        "consumption_profiles": []
      }
    ],
    "summary": {
      "total_devices": 1,
      "total_daily_kwh": 6,
      "total_monthly_kwh": 182.5,
      "total_yearly_kwh": 2190,
      "total_yearly_cost_eur": 438,
      "slovak_average_kwh": 4500,
      "comparison_percent": 48.7,
      "comparison_label": "Nízka spotreba"
    },
    "energy_vampires": [
      { "id": 1, "name": "Bojler v kúpeľni", "category": "boiler", ... }
    ]
  }
}

Detail zariadenia

GET /api/v1/energy-audit/{device}

Podrobné informácie o zariadení vrátane hodinových profilov spotreby.

Odpoveď:

{
  "success": true,
  "data": {
    "id": 1,
    "name": "Bojler v kúpeľni",
    "category": "boiler",
    "category_label": "Bojler / Ohrievač vody",
    "power_rating_w": 2000,
    "daily_hours": 3,
    "quantity": 1,
    "is_always_on": false,
    "standby_power_w": 0,
    "seasonality": { "1": 1.5, "2": 1.4, ... },
    "notes": null,
    "calculations": {
      "daily_kwh": 6,
      "monthly_kwh": 182.5,
      "yearly_kwh": 2190,
      "yearly_cost_eur": 438
    },
    "consumption_profiles": [
      { "hour": 5, "usage_factor": 0.2, "power_override_w": null },
      { "hour": 6, "usage_factor": 0.5, "power_override_w": null },
      { "hour": 21, "usage_factor": 0.9, "power_override_w": null }
    ]
  }
}

Vytvoriť zariadenie

POST /api/v1/energy-audit

Parametre:

|-----------|-----|---------|-------|

Odpoveď:

{
  "success": true,
  "message": "Zariadenie bolo pridané.",
  "data": {
    "id": 1,
    "name": "Nová práčka",
    "category": "washing_machine",
    "calculations": {
      "daily_kwh": 3,
      "yearly_kwh": 1095
    }
  }
}

Upraviť zariadenie

PUT /api/v1/energy-audit/{device}

Rovnaké parametre ako pri vytváraní (všetky optional).

Odpoveď:

{
  "success": true,
  "message": "Zariadenie bolo upravené.",
  "data": {
    "id": 1,
    "calculations": {
      "daily_kwh": 6,
      "yearly_kwh": 2190
    }
  }
}

Zmazať zariadenie

DELETE /api/v1/energy-audit/{device}

Odpoveď:

{
  "success": true,
  "message": "Zariadenie bolo odstránené."
}

Kategórie zariadení

GET /api/v1/energy-audit/categories

Vráti všetky dostupné kategórie s default hodnotami.

Odpoveď:

{
  "success": true,
  "data": [
    {
      "key": "boiler",
      "label": "Bojler / Ohrievač vody",
      "defaults": {
        "power_rating_w": 2000,
        "daily_hours": 3,
        "seasonality": { "1": 1.5, "2": 1.4, ... }
      }
    },
    ...
  ]
}

Kategórie zariadení

| Kľúč | Popis |

|------|-------|

| boiler | Bojler / Ohrievač vody |

| heat_pump | Tepelné čerpadlo |

| ac | Klimatizácia |

| washing_machine | Práčka |

| dryer | Sušička |

| dishwasher | Umývačka riadu |

| induction_cooktop | Indukčná varná doska |

| oven | Rúra |

| lighting | Osvetlenie |

| tv | Televízor |

| pc | Počítač / Notebook |

| ev_charger | Nabíjačka EV |

| fridge | Chladnička |

| freezer | Mraznička |

| router | Router / Sieťové zariadenia |

| other | Iné |

Produktové odporúčania

Použite endpoint /api/v1/recommendations pre produktové odporúčania na základe energetickej zoznámky a FVE dát.

SScloud — Inteligentné riešenia pre fotovoltiku