FVE API – Čakovice 920

Rozhraní pro strojové čtení osobního podílu na výrobě solární energie. API běží lokálně na zabezpečené síti a je optimalizované pro systémy domácí automatizace.

Základní informace

Base URL: https://fve.cakovice920.cz

Formát dat: Všechny odpovědi jsou vraceny jako čistý application/json v kódování UTF-8.

Autentizace

Každý požadavek musí obsahovat bezpečnostní API token, který vám přidělil správce. Token se předává v HTTP hlavičce jako X-FVE-Token. Požadavky bez platného tokenu budou odmítnuty s chybou 401 nebo 403.

Přehled endpointů

Metoda	Endpoint	Popis	Doporučená frekvence
GET	/api/v1/fve/live	Aktuální výkon a dnešní suma (přepočteno na váš podíl)	Max. 1x za minutu
GET	/api/v1/fve/history	Agregovaná historie za 7 dní a 12 měsíců	Max. 1x za hodinu

1. Živá data: GET /fve/live

Endpoint slouží pro real-time sledování a spouštění domácích automatizací na základě aktuální výroby.

Příklad volání přes cURL:

curl -H "X-FVE-Token: VÁŠ_UNIKÁTNÍ_TOKEN" https://fve.cakovice920.cz/api/v1/fve/live

Úspěšná odpověď (200 OK):

{
  "current_w": 248,
  "today_kwh": 0.45,
  "updated_at": "16:30:00"
}

Poznámka: Čas updated_at odpovídá poslednímu zápisu ze střídače v lokálním čase (Europe/Prague).

2. Historická data: GET /fve/history

Endpoint vrací agregovaná data spotřeby vhodná pro dlouhodobé statistiky. Hodnoty jsou již vynásobeny vaším podílem.

Příklad volání přes cURL:

curl -H "X-FVE-Token: VÁŠ_UNIKÁTNÍ_TOKEN" https://fve.cakovice920.cz/api/v1/fve/history

Úspěšná odpověď (200 OK):

{
  "history_days": [
    { "date": "01.06.", "kwh": 0.45 },
    { "date": "31.05.", "kwh": 4.12 }
  ],
  "history_months": [
    { "month": "06/2026", "kwh": 0.5 },
    { "month": "05/2026", "kwh": 142.3 }
  ]
}

Integrace do Home Assistant

Pro integraci do vašeho chytrého domova vložte následující blok kódu do souboru configuration.yaml. Senzor dnešní výroby je plně kompatibilní s vestavěným Energy Dashboardem.

rest:
  - resource: https://fve.cakovice920.cz/api/v1/fve/live
    scan_interval: 60
    headers:
      X-FVE-Token: "VÁŠ_UNIKÁTNÍ_TOKEN"
    sensor:
      - name: "FVE Aktuální výkon pro byt"
        value_template: "{{ value_json.current_w }}"
        unit_of_measurement: "W"
        device_class: power
        state_class: measurement

      - name: "FVE Dnes vyrobeno pro byt"
        value_template: "{{ value_json.today_kwh }}"
        unit_of_measurement: "kWh"
        device_class: energy
        state_class: total_increasing

      - name: "FVE Poslední aktualizace"
        value_template: "{{ value_json.updated_at }}"

Chybové stavy

• 401 Unauthorized – V požadavku chybí hlavička X-FVE-Token.
• 403 Forbidden – Token je neplatný nebo byl deaktivován.
• 500 Internal Server Error – Interní chyba databáze na serveru.