Solar API v1

Verejné JSON API so živými dátami elektrární Hotel Raj, Wellness Raj a FVE TD SL · späť na prehľad

API je len na čítanie a nevyžaduje prihlásenie. Dáta sa obnovujú každú minútu zo Solinteg Cloud. Odpovede sú vo formáte JSON (UTF-8) a podporujú CORS, takže ich možno volať priamo z iného webu. Strojovo čitateľná špecifikácia: /api/v1/openapi.json (OpenAPI 3).

Endpointy

Metóda a cestaPopisCache
GET /api/v1/plantsAktuálny stav všetkých elektrární30 s
GET /api/v1/plants/{id}Aktuálny stav jednej elektrárne30 s
GET /api/v1/plants/{id}/history?hours=24Minútová história výkonu, hours = 1–16860 s

Identifikátory elektrární: hotel-raj, wellness-raj, fve-tdsl.

Polia

PoleJednotkaVýznam
status–online · partial (nie všetky striedače posielajú dáta) · offline · stale (posledné meranie staršie ako 15 min)
data_quality–ok alebo suspect; pri suspect sú power_kw.grid a power_kw.load = null a dôvod je v data_quality_notes
measured_atISO 8601Čas posledného merania zo striedača (miestny čas s posunom)
power_kw.pvkWVýkon fotovoltiky
power_kw.gridkWSieť: kladné = dodávka do siete, záporné = odber zo siete
power_kw.batterykWBatéria: kladné = vybíjanie, záporné = nabíjanie
power_kw.loadkWSpotreba = FV + batéria − sieť
battery_soc_pct%Stav nabitia batérie
energy_today_kwh.*kWhDnešná výroba, nákup a predaj zo/do siete, nabitie a vybitie batérie

Príklad odpovede

GET /api/v1/plants/hotel-raj

{
  "data": {
    "id": "hotel-raj",
    "name": "Hotel Raj",
    "capacity_kwp": 40.0,
    "status": "online",
    "data_quality": "ok",
    "data_quality_notes": [],
    "measured_at": "2026-10-23T18:18:46+02:00",
    "fetched_at": "2026-10-23T16:19:43+00:00",
    "power_kw": { "pv": 0.0, "grid": -9.865, "battery": 0.01, "load": 9.875 },
    "battery_soc_pct": 6.0,
    "energy_today_kwh": { "pv": 72.7, "grid_import": 166.1, "grid_export": 1.2,
                          "battery_charge": 6.2, "battery_discharge": 4.8 },
    "devices": { "online": 2, "total": 2 }
  },
  "meta": { "api_version": "1.0", "generated_at": "2026-10-23T16:19:43+00:00", ... }
}

Chyby

Chyby majú jednotný tvar {"error": {"code", "message", "documentation"}} a štandardné HTTP kódy: 400 neplatný parameter, 404 neznámy endpoint alebo elektráreň, 405 nepovolená metóda (API prijíma len GET, HEAD, OPTIONS), 503 dáta ešte nie sú k dispozícii.

Odporúčania