Data přímo z platformy
Stejná vrstva, ze které čtou stránky samotného webu. Bez klíče, bez registrace, JSON přes HTTP. Každá odpověď uvádí, z jakého zdroje pochází, k jakému okamžiku se vztahuje a jak je čerstvá.
Elektrizační soustava v reálném čase
Spotřeba, výroba podle zdrojů a přeshraniční výměny tak, jak je zveřejňují provozovatelé přenosových soustav. Otevřené.
| Adresa | Co vrací | Četnost |
|---|---|---|
/api/v1/countries |
Všechny země na platformě s jejich zónami a stavem pokrytí. | Mění se zřídka — když se změní registr. |
/api/v1/countries/:iso2/latest |
Okamžitý stav země: spotřeba, výroba podle zdrojů, saldo na hranicích. | Tak často, jak publikuje její provozovatel — od 10 sekund do hodiny. |
/api/v1/countries/:iso2/history |
Časová řada pro jednu zemi ve zvoleném rozsahu. | Stejná četnost jako okamžitý stav. |
/api/v1/europe/latest |
Evropský součet a všechny země, které do něj vstupují. | Jedna minuta. |
/api/v1/status |
Stav sběru dat: který zdroj publikoval naposledy a kdy. | Průběžně. |
/api/v1/licenses |
Co smí platforma dělat s daty jednotlivých zdrojů. | Když se změní podmínky zdroje. |
/api/v1/search |
Hledání v zemích, zónách a pojmech. | Průběžně. |
Denní trh
Ceny vydražené na následující den, podle nabídkové zóny. Zatím uzavřené — proč, vysvětlujeme níže.
| Adresa | Co vrací | Četnost |
|---|---|---|
/api/v1/prices/latest451 · licence |
Poslední známá cena pro každou zónu. | Jednou denně, po aukci. |
/api/v1/prices/zones451 · licence |
Nabídkové zóny, každá s časovým pásmem a měnou. | Mění se zřídka. |
/api/v1/prices/date451 · licence |
Všechny zóny pro zvolený den dodávky. | Denně. |
/api/v1/prices/country/:iso2451 · licence |
Ceny země pro každou z jejích zón. | Denně. |
/api/v1/prices/:zone/history451 · licence |
Historie zóny, interval po intervalu. | Denně. |
/api/v1/prices/:zone/summary451 · licence |
Průměr, minimum, maximum a kvantily po dnech, týdnech nebo měsících. | Denně. |
/api/v1/market/cheapest451 · licence |
Zóny s nejnižší průměrnou cenou dne. | Denně. |
/api/v1/market/expensive451 · licence |
Zóny s nejvyšší průměrnou cenou dne. | Denně. |
/api/v1/market/spreads451 · licence |
Rozdíl mezi nejlevnější a nejdražší hodinou, podle zóny. | Denně. |
/api/v1/market/cheapest-window451 · licence |
Nejlevnější souvislé N-hodinové okno v zóně. | Denně. |
/api/v1/market/weekly451 · licence |
Týdenní zpráva, jakmile týden skončí. | Týdně. |
Proč cenové cesty odpovídají kódem 451
Tržní data pocházejí z platformy transparentnosti ENTSO-E. Sbíráme je a zobrazujeme na webu se zdrojem uvedeným u každého čísla, ale jejich další šíření přes API není totéž co jejich zobrazení a podmínky dalšího užití jsme zatím neověřili ani nezaevidovali.
Do té doby cenové cesty vracejí 451 — kód pro „nedostupné z právních důvodů“ — místo toho, aby potichu dodávaly něco, k čemu nemáme právo. Licenční systém funguje po zdrojích, ne po zemích, takže jejich otevření nevyžaduje žádnou změnu kódu.
Pravidla slušného chování
Limit požadavků neexistuje a byli bychom rádi, kdyby ho nebylo třeba. Odpovědi nesou cache-control: respektujte ho a dostanete přesně stejná čísla, aniž byste se ptali dvakrát. Data v reálném čase se nemění častěji, než je publikuje jejich provozovatel — jeden požadavek za sekundu pro zemi, která publikuje jednou za hodinu, nepřinese nic nového.
Pokud data používáte veřejně, uvádějte původní zdroj (provozovatele přenosové soustavy nebo ENTSO-E), ne naše jméno: data přenášíme, nevyrábíme je.
Viz také: Zdroje dat · Metodika · Stav systému · llms.txt