Specifikace
Verze 1.0.0-beta, OpenAPI 3.1.0, základní adresa https://www.itexservices.cz/api/spot/v1. Specifikaci si stáhněte a otevřete v Postmanu, Insomnii nebo generátoru klienta: openapi.json. Návody a ukázky jsou v dokumentaci API, historie verzí v přehledu změn.
Vyhlášené ceny denního trhu na dnešek a zítřek a za nimi naše předpověď na zbytek týdne po hodinách, s pásmem nejistoty p10–p90. Ceny v Kč/kWh, časy ISO 8601 s posunem Europe/Prague, názvy polí česky bez diakritiky.
Limity: 60 dotazů za hodinu a 500 za den na klíč (úroveň Zdarma 100 za den); navíc 30 dotazů za minutu z jedné IP adresy napříč klíči (i pro stav.json) a nejvýš 10 neplatných pokusů o klíč za 10 minut z jedné adresy. Překročení vrátí 429 s hlavičkou Retry-After. Data se mění několikrát denně — doporučený interval: Loxone 300 s, Home Assistant 15 min, evcc 1 h.
Verzování: přidání pole není změna verze; odebrání pole nebo změna významu znamená /v2 a /v1 poběží dál nejméně 12 měsíců.
Beta provoz zdarma. Předpověď je orientační údaj, ne záruka.
Autentizace
| Způsob | Popis |
|---|---|
Bearer | Authorization: Bearer its_… — doporučeno pro Home Assistant, Node-RED, evcc a vlastní kód. |
Basic | Klíč jako uživatel NEBO heslo (druhé pole libovolné). Pro Loxone: https://its_…@www.itexservices.cz/…. |
/k/{klic}/… | API klíč přímo v cestě (pro Loxone a jednoduché skripty). Odpověď smí cachovat i CDN. |
Endpointy
- /vyhled.json — Výhled ceny na 7 dní
- /ted.json — Cena teď a nejbližší okna
- /okna.json — Nejlevnější a nejdražší okna
- /loxone.txt — Výstup pro Loxone
- /evcc.json — Vlastní tarif pro evcc
- /schedule.json — Rozvrh spotřeby
- /export.json — Kdy omezit přetoky
- /stav.json — Stav dat (bez klíče)
GET/vyhled.json
Výhled ceny na 7 dní
Hodinová řada: vyhlášené ceny denního trhu, za nimi naše předpověď s pásmem p10–p90.
Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/vyhled.json.
| Parametr | Typ | Popis |
|---|---|---|
krok | 15 | 60 (výchozí 60) | Délka slotu v minutách. Čtvrthodiny jen u vyhlášených cen; předpověď se opakuje. |
hodin | integer (1–200, výchozí 200) | Kolik hodin řady vrátit. |
strategie | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50) | Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90. |
strategy | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" | Anglický alias parametru strategie. |
| Odpověď | Popis |
|---|---|
200 | Řada slotů. Schéma: Vyhled. |
401 | Chybí klíč, má špatný tvar, nebo je neplatný či zrušený. |
422 | Neznámý parametr nebo hodnota mimo rozsah. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Dočasný výpadek (data nebo databáze). Hlavička Retry-After. |
{
"verze": "1",
"beta": true,
"stav": "ok",
"vydano": "2026-11-18T14:15:00+01:00",
"vytvoreno": "2026-11-18T14:21:10+01:00",
"dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
"stari_min": 42,
"mena": "CZK",
"jednotka": "Kc/kWh",
"kurz_eur": 24.38,
"uroven_klice": "beta",
"strategie": "p50",
"tarif": {
"pouzit": true,
"dph": true
},
"krok": 60,
"rozliseni_predpovedi": 60,
"sloty": [
{
"od": "2026-11-21T12:00:00+01:00",
"do": "2026-11-21T13:00:00+01:00",
"zdroj": "predpoved",
"spot": 1.95,
"p10": 1.1,
"p50": 1.95,
"p90": 2.9,
"uroven": "levna",
"poradi_dne": 1,
"p_zaporna": 0.1
}
]
}GET/ted.json
Cena teď a nejbližší okna
Cena a úroveň běžící hodiny, nejlevnější a nejdražší 3h okno, riziko záporné ceny a „počkat“.
Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/ted.json.
| Parametr | Typ | Popis |
|---|---|---|
strategie | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50) | Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90. |
strategy | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" | Anglický alias parametru strategie. |
| Odpověď | Popis |
|---|---|
200 | Stav teď. Schéma: Ted. |
401 | Chybí klíč, má špatný tvar, nebo je neplatný či zrušený. |
422 | Neznámý parametr nebo hodnota mimo rozsah. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Dočasný výpadek (data nebo databáze). Hlavička Retry-After. |
{
"verze": "1",
"beta": true,
"stav": "ok",
"vydano": "2026-11-18T14:15:00+01:00",
"vytvoreno": "2026-11-18T14:21:10+01:00",
"dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
"stari_min": 42,
"mena": "CZK",
"jednotka": "Kc/kWh",
"kurz_eur": 24.38,
"uroven_klice": "beta",
"strategie": "p50",
"tarif": {
"pouzit": true,
"dph": true
},
"ted": {
"od": "2026-11-18T15:00:00+01:00",
"do": "2026-11-18T16:00:00+01:00",
"zdroj": "trh",
"spot": 2.31,
"koncova": 4.012,
"uroven": "levna",
"poradi_dne": 6,
"p_zaporna": 0
},
"cena_ted": 4.012,
"spot_ted": 2.31,
"uroven_ted": "levna",
"levno_ted": true,
"zmena_urovne_v": "2026-11-18T16:00:00+01:00",
"okno_3h": {
"od": "2026-11-19T12:00:00+01:00",
"do": "2026-11-19T15:00:00+01:00",
"cena": 1.84,
"cena_p10": 1.84,
"cena_p90": 1.84,
"jistota": "vysoka",
"koncova": 3.41,
"za_min": 1245
},
"nejdrazsi_3h": {
"od": "2026-11-18T17:00:00+01:00",
"do": "2026-11-18T20:00:00+01:00",
"cena": 4.6,
"cena_p10": 4.6,
"cena_p90": 4.6,
"jistota": "vysoka",
"koncova": 6.9,
"za_min": 105
},
"p_zaporna_dnes": 0,
"pockat": {
"beta": true,
"delka": 3,
"rozdil": 0.3,
"nejlepsi_znama": {
"od": "2026-11-19T12:00:00+01:00",
"do": "2026-11-19T15:00:00+01:00",
"cena": 1.84
},
"levneji_pozdeji": "stredni"
}
}GET/okna.json
Nejlevnější a nejdražší okna
Nepřekrývající se souvislá okna dané délky od běžící hodiny.
Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/okna.json.
| Parametr | Typ | Popis |
|---|---|---|
delka | integer (1–12, výchozí 3) | Délka okna v hodinách. |
pocet | integer (1–5, výchozí 3) | Kolik oken vrátit. |
do | string | Hledat jen okna končící do tohoto času. ISO 8601; bez posunu = místní čas v Praze. V budoucnosti, nejvýš 9 dní dopředu. |
strategie | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50) | Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90. |
strategy | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" | Anglický alias parametru strategie. |
| Odpověď | Popis |
|---|---|
200 | Okna. Schéma: Okna. |
401 | Chybí klíč, má špatný tvar, nebo je neplatný či zrušený. |
422 | Neznámý parametr nebo hodnota mimo rozsah. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Dočasný výpadek (data nebo databáze). Hlavička Retry-After. |
{
"verze": "1",
"beta": true,
"stav": "ok",
"vydano": "2026-11-18T14:15:00+01:00",
"vytvoreno": "2026-11-18T14:21:10+01:00",
"dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
"stari_min": 42,
"mena": "CZK",
"jednotka": "Kc/kWh",
"kurz_eur": 24.38,
"uroven_klice": "beta",
"strategie": "p50",
"tarif": {
"pouzit": true,
"dph": true
},
"delka": 3,
"do": null,
"nejlevnejsi": [
{
"od": "2026-11-19T12:00:00+01:00",
"do": "2026-11-19T15:00:00+01:00",
"cena": 1.84,
"cena_p10": 1.84,
"cena_p90": 1.84,
"jistota": "vysoka",
"koncova": 3.41,
"za_min": 1245
}
],
"nejdrazsi": [
{
"od": "2026-11-18T17:00:00+01:00",
"do": "2026-11-18T20:00:00+01:00",
"cena": 4.6,
"cena_p10": 4.6,
"cena_p90": 4.6,
"jistota": "vysoka",
"koncova": 6.9,
"za_min": 105
}
]
}GET/loxone.txt
Výstup pro Loxone
Totéž co ted.json jako řádky nazev=hodnota + ceny na 48 h (h00 = běžící hodina). Desetinná tečka, chybějící hodnota = -999, stav_kod vždy první. Rozpoznání v Loxone: \icena_ted=\i\v.
Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/loxone.txt.
| Parametr | Typ | Popis |
|---|---|---|
strategie | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50) | Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90. |
strategy | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" | Anglický alias parametru strategie. |
| Odpověď | Popis |
|---|---|
200 | Text pro Virtual HTTP Input. |
401 | Chybí klíč, má špatný tvar, nebo je neplatný či zrušený. |
422 | Neznámý parametr nebo hodnota mimo rozsah. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Dočasný výpadek (data nebo databáze). Hlavička Retry-After. |
stav_kod=0
stav=ok
cena_ted=4.012
spot_ted=2.31
levno_ted=1
uroven_ted=1
okno3_za_min=185
okno3_cena=3.41
drahe3_za_min=125
drahe3_cena=6.9
pockat_uroven=1
zaporna_dnes_p=0
stari_min=42
h00=4.012
h01=4.105
…
h47=3.88
GET/evcc.json
Vlastní tarif pro evcc
Pole {start, end, value} od běžící hodiny, časy v UTC se Z. value je koncová cena, má-li klíč tarif, jinak spot.
Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/evcc.json.
| Parametr | Typ | Popis |
|---|---|---|
strategie | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50) | Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90. |
strategy | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" | Anglický alias parametru strategie. |
| Odpověď | Popis |
|---|---|
200 | Ceny pro evcc. Schéma: EvccSlot[]. |
401 | Chybí klíč, má špatný tvar, nebo je neplatný či zrušený. |
422 | Neznámý parametr nebo hodnota mimo rozsah. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Dočasný výpadek (data nebo databáze). Hlavička Retry-After. |
[
{
"start": "2026-11-18T14:00:00Z",
"end": "2026-11-18T15:00:00Z",
"value": 4.012
}
]GET/schedule.json
Rozvrh spotřeby
N nejlevnějších hodin v každém dni, nebo cílové nabíjení (kwh + kw, volitelně do a ucinnost). pod přidá každou hodinu pod hranicí.
Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/schedule.json.
| Parametr | Typ | Popis |
|---|---|---|
hodin | integer (0–24, výchozí 4) | Kolik nejlevnějších hodin v každém dni vybrat (výchozí 4, se zadaným pod 0). |
pod | number (-10–50) | Přidat každou hodinu s cenou pod touto hranicí (Kč/kWh, cena pro uživatele). |
kwh | number (0.1–500) | Cílové nabíjení: kolik kWh dodat. Vyžaduje kw. |
kw | number (0.1–100) | Výkon nabíjení v kW (k parametru kwh). |
do | string | Termín cílového nabíjení. ISO 8601; bez posunu = místní čas v Praze. |
ucinnost | number (0.5–1, výchozí 0.9) | Účinnost nabíjení. |
strategie | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50) | Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90. |
strategy | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" | Anglický alias parametru strategie. |
| Odpověď | Popis |
|---|---|
200 | Rozvrh. Schéma: Rozvrh. |
401 | Chybí klíč, má špatný tvar, nebo je neplatný či zrušený. |
422 | Neznámý parametr nebo hodnota mimo rozsah. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Dočasný výpadek (data nebo databáze). Hlavička Retry-After. |
{
"verze": "1",
"beta": true,
"stav": "ok",
"vydano": "2026-11-18T14:15:00+01:00",
"vytvoreno": "2026-11-18T14:21:10+01:00",
"dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
"stari_min": 42,
"mena": "CZK",
"jednotka": "Kc/kWh",
"kurz_eur": 24.38,
"uroven_klice": "beta",
"strategie": "p50",
"tarif": {
"pouzit": true,
"dph": true
},
"rezim": "hodiny_denne",
"hodin_vybrano": 2,
"aktivni_ted": false,
"aktivni_do": null,
"dalsi_od": "2026-11-19T12:00:00+01:00",
"intervaly": [
{
"od": "2026-11-19T12:00:00+01:00",
"do": "2026-11-19T14:00:00+01:00"
}
],
"unix": [
[
1795086000,
1795093200
]
],
"hodiny": [
{
"od": "2026-11-19T12:00:00+01:00",
"cena": 3.3,
"zdroj": "trh"
},
{
"od": "2026-11-19T13:00:00+01:00",
"cena": 3.4,
"zdroj": "trh"
}
]
}GET/export.json
Kdy omezit přetoky
Hodiny, kdy výkupní cena (spot − poplatek) klesne pod práh.
Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/export.json.
| Parametr | Typ | Popis |
|---|---|---|
poplatek | number (0–10) | Poplatek výkupce v Kč/kWh. Výchozí z tarifu klíče, jinak 0. |
prah | number (-10–10, výchozí 0) | Omezit přetoky, když výkupní cena klesne pod tuto hodnotu (Kč/kWh). |
strategie | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50) | Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90. |
strategy | "p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" | Anglický alias parametru strategie. |
| Odpověď | Popis |
|---|---|
200 | Omezení přetoků. Schéma: Export. |
401 | Chybí klíč, má špatný tvar, nebo je neplatný či zrušený. |
422 | Neznámý parametr nebo hodnota mimo rozsah. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Dočasný výpadek (data nebo databáze). Hlavička Retry-After. |
{
"verze": "1",
"beta": true,
"stav": "ok",
"vydano": "2026-11-18T14:15:00+01:00",
"vytvoreno": "2026-11-18T14:21:10+01:00",
"dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
"stari_min": 42,
"mena": "CZK",
"jednotka": "Kc/kWh",
"kurz_eur": 24.38,
"uroven_klice": "beta",
"strategie": "p50",
"tarif": {
"pouzit": true,
"dph": true
},
"poplatek": 0.5,
"prah": 0,
"aktivni_ted": false,
"aktivni_do": null,
"dalsi_od": "2026-11-22T12:00:00+01:00",
"intervaly": [
{
"od": "2026-11-22T12:00:00+01:00",
"do": "2026-11-22T13:00:00+01:00"
}
],
"unix": [
[
1795345200,
1795348800
]
],
"hodiny": [
{
"od": "2026-11-22T12:00:00+01:00",
"vykup": -0.12,
"zdroj": "predpoved",
"p_vykup_pod_prahem": 0.6
}
]
}GET/stav.json
Stav dat (bez klíče)
Čas posledního vydání a stáří dat. Bez klíče, ale limit podle IP platí.
Autentizace: bez klíče (limit podle IP platí).
| Odpověď | Popis |
|---|---|
200 | Stav. Schéma: Stav. |
429 | Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After. |
503 | Data nejsou k dispozici. Hlavička Retry-After. |
{
"verze": "1",
"beta": true,
"stav": "ok",
"vydano": "2026-11-18T14:15:00+01:00",
"vytvoreno": "2026-11-18T14:21:10+01:00",
"dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
"stari_min": 42,
"znama_do": "2026-11-20T00:00:00+01:00",
"predpoved_do": "2026-11-26T00:00:00+01:00"
}Schémata
Hlavicka
Společná hlavička všech JSON odpovědí s klíčem (kromě evcc.json).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
verze | "1" | ano | Hlavní verze API. |
beta | true | ano | API je v beta provozu. |
stav | "ok" | "stara_data" | ano | stara_data, když jsou data starší než 30 hodin. |
vydano | string (date-time) | null | ano | Kdy jsme výhled vydali (ISO 8601 s posunem Europe/Prague). |
vytvoreno | string (date-time) | ano | Kdy vznikl dokument, ze kterého odpověď počítáme. |
dalsi_aktualizace | string (date-time) | ano | Nejbližší plánovaná obnova dat. Dřívější dotaz nic nového nepřinese. |
stari_min | integer (0–…) | ano | Stáří dat v minutách. |
mena | "CZK" | ano | |
jednotka | "Kc/kWh" | ano | |
kurz_eur | number | ano | Kurz EUR/CZK (ČNB), kterým jsme přepočetli ceny trhu. |
uroven_klice | "beta" | "zdarma" | "placeny" | ano | Úroveň klíče. zdarma dostane předpověď jen 48 h za poslední vyhlášenou hodinou a bez pásma. |
strategie | Strategie | ano | |
tarif | object | ano | Pole: pouzit, dph. |
Strategie
Která hodnota předpovědi se bere jako „cena“: p10 (optimisticky nízko), p50 (střed), p90 (opatrně vysoko).
Typ: "p10" | "p50" | "p90"
Uroven
levna = nejlevnější třetina hodin dne, draha = nejdražší třetina, zaporna = cena pod nulou.
Typ: "zaporna" | "levna" | "bezna" | "draha" | null
Slot
Jedna hodina (nebo čtvrthodina u krok=15).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
od | string (date-time) | ano | Začátek. |
do | string (date-time) | ano | Konec. |
zdroj | "trh" | "predpoved" | ano | trh = vyhlášená cena denního trhu, predpoved = náš odhad. |
spot | number | ano | Spotová cena bez DPH a distribuce (Kč/kWh); u předpovědi podle strategie. |
p10 | number | ne | Dolní okraj pásma předpovědi. Jen u předpovědi a ne u úrovně Zdarma. |
p50 | number | ne | Střed předpovědi. Jen u předpovědi a ne u úrovně Zdarma. |
p90 | number | ne | Horní okraj pásma předpovědi. Jen u předpovědi a ne u úrovně Zdarma. |
koncova | number | ne | Koncová cena podle tarifu klíče. Jen když má klíč tarif. |
koncova_p10 | number | ne | Koncová cena z p10. Jen s tarifem a pásmem. |
koncova_p90 | number | ne | Koncová cena z p90. Jen s tarifem a pásmem. |
vykup | number | ne | Výkupní cena = spot − poplatek výkupce. Jen když tarif klíče nese poplatek za výkup. |
p_vykup_zaporny | number | null (0–1) | ne | Pravděpodobnost záporné výkupní ceny. Jen s poplatkem za výkup. |
uroven | Uroven | ano | |
poradi_dne | integer | null (1–…) | ano | Pořadí hodiny ve dni podle ceny, 1 = nejlevnější. |
p_zaporna | number | null (0–1) | ano | Pravděpodobnost záporné ceny po desetinách; u vyhlášených hodin 0 nebo 1. 0.1 = nejvýš 10 %, 0.9 = aspoň 90 %. |
Okno
Souvislé okno hodin; okna se nepřekrývají.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
od | string (date-time) | ano | Začátek okna. |
do | string (date-time) | ano | Konec okna. |
cena | number | ano | Průměrný spot okna (Kč/kWh). |
cena_p10 | number | ano | Průměr p10 hodin okna. |
cena_p90 | number | ano | Průměr p90 hodin okna. |
jistota | "vysoka" | "stredni" | "nizka" | ano | vysoka = všechny hodiny vyhlášené, stredni = do 3 dnů, nizka = dál. |
koncova | number | ne | Průměrná koncová cena. Jen když má klíč tarif. |
za_min | integer (0–…) | ano | Za kolik minut okno začne (0 = právě běží). |
Pockat
„Nabít teď, nebo počkat?“ V betě jen slovně.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
beta | true | ano | |
delka | integer | ano | Délka okna v hodinách. |
rozdil | number | ano | O kolik (Kč/kWh) musí být pozdější okno levnější. |
nejlepsi_znama | object | null | ano | |
levneji_pozdeji | "nizka" | "stredni" | "vysoka" | ano | Jak pravděpodobné je, že v příštích dnech vyjde okno levnější než nejlepší známé. |
Intervaly
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
aktivni_ted | boolean | ano | Běží právě teď vybraný interval. |
aktivni_do | string (date-time) | null | ano | Konec běžícího intervalu. |
dalsi_od | string (date-time) | null | ano | Začátek dalšího intervalu. |
intervaly | object[] | ano | |
unix | [integer, integer][] | ano | Tytéž intervaly jako dvojice [začátek, konec] v unixových sekundách (Shelly skripty). |
Vyhled
Obsahuje všechna pole z Hlavicka a navíc:
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
krok | 15 | 60 | ano | Délka slotu v minutách. |
rozliseni_predpovedi | 60 | ano | Předpověď je hodinová; u krok=15 se hodnota opakuje po čtvrthodinách. |
sloty | Slot[] | ano |
Ted
Obsahuje všechna pole z Hlavicka a navíc:
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ted | Slot | null | ano | |
cena_ted | number | null | ano | Cena teď: koncová, má-li klíč tarif, jinak spot. |
spot_ted | number | null | ano | Spot teď. |
uroven_ted | Uroven | ano | |
levno_ted | boolean | null | ano | Levná nebo záporná hodina. |
zmena_urovne_v | string (date-time) | null | ano | Kdy se úroveň změní. |
okno_3h | Okno | null | ano | |
nejdrazsi_3h | Okno | null | ano | |
p_zaporna_dnes | number | null | ano | Nejvyšší pravděpodobnost záporné ceny do konce dne. |
pockat | Pockat | null | ano |
Okna
Obsahuje všechna pole z Hlavicka a navíc:
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
delka | integer | ano | Délka oken v hodinách. |
do | string (date-time) | null | ano | Hledá se jen do tohoto času (parametr do). |
nejlevnejsi | Okno[] | ano | |
nejdrazsi | Okno[] | ano |
Rozvrh
Obsahuje všechna pole z Hlavicka a Intervaly a navíc:
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
rezim | "hodiny_denne" | "nabijeni" | ano | nabijeni při zadaném kwh, jinak N hodin denně. |
hodin_vybrano | integer (0–…) | ano | |
hodiny | object[] | ano |
Export
Obsahuje všechna pole z Hlavicka a Intervaly a navíc:
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
poplatek | number | ano | Použitý poplatek výkupce. |
prah | number | ano | Použitý práh výkupní ceny. |
hodiny | object[] | ano |
EvccSlot
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
start | string (date-time) | ano | Začátek v UTC se Z. |
end | string (date-time) | ano | Konec v UTC se Z. |
value | number | ano | Cena pro uživatele (Kč/kWh). |
Stav
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
verze | "1" | ano | |
beta | true | ano | |
stav | "ok" | "stara_data" | ano | |
vydano | string (date-time) | null | ano | Kdy jsme výhled vydali. |
vytvoreno | string (date-time) | ano | Kdy vznikl dokument. |
dalsi_aktualizace | string (date-time) | ano | Nejbližší plánovaná obnova. |
stari_min | integer (0–…) | ano | |
znama_do | string (date-time) | null | ano | Konec poslední vyhlášené hodiny. |
predpoved_do | string (date-time) | ano | Konec předpovědi. |
Chyba
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
verze | "1" | ano | |
stav | "neplatny_klic" | "limit" | "neplatny_parametr" | "nedostupne" | "nenalezeno" | ano | |
chyba | string | ne | Popis chyby česky. |