Údaje priamo z platformy
Tá istá vrstva, z ktorej čítajú stránky webu. Bez kľúča, bez registrácie, JSON cez HTTP. Každá odpoveď uvádza, z ktorého zdroja pochádza, na ktorý okamih sa vzťahuje a aká je čerstvá.
Elektrizačná sústava v reálnom čase
Spotreba, výroba podľa zdrojov a cezhraničné výmeny, ako ich zverejňujú prevádzkovatelia prenosových sústav. Otvorené.
| Adresa | Čo vracia | Periodicita |
|---|---|---|
/api/v1/countries |
Všetky krajiny na platforme, s ich oblasťami a stavom pokrytia. | Mení sa zriedka — keď sa zmení register. |
/api/v1/countries/:iso2/latest |
Aktuálny stav krajiny: spotreba, výroba podľa zdrojov, saldo na hraniciach. | Tak často, ako zverejňuje jej prevádzkovateľ — od 10 sekúnd po hodinu. |
/api/v1/countries/:iso2/history |
Časový rad pre jednu krajinu za zvolený rozsah. | Rovnaká periodicita ako pri aktuálnom stave. |
/api/v1/europe/latest |
Európsky súčet a všetky krajiny, ktoré doň vstupujú. | Jedna minúta. |
/api/v1/status |
Stav zberu: ktorý zdroj zverejnil údaje naposledy a kedy. | Priebežne. |
/api/v1/licenses |
Čo smie platforma robiť s údajmi každého zdroja. | Keď sa zmenia podmienky zdroja. |
/api/v1/search |
Vyhľadávanie v krajinách, oblastiach a pojmoch. | Priebežne. |
Denný trh
Ceny vydražené na nasledujúci deň, podľa ponukovej oblasti. Zatiaľ uzavreté — prečo, vysvetľujeme nižšie.
| Adresa | Čo vracia | Periodicita |
|---|---|---|
/api/v1/prices/latest451 · licencia |
Posledná známa cena pre každú oblasť. | Raz denne, po aukcii. |
/api/v1/prices/zones451 · licencia |
Ponukové oblasti, s časovým pásmom a menou každej z nich. | Mení sa zriedka. |
/api/v1/prices/date451 · licencia |
Všetky oblasti pre zvolený deň dodávky. | Denne. |
/api/v1/prices/country/:iso2451 · licencia |
Ceny krajiny pre každú z jej oblastí. | Denne. |
/api/v1/prices/:zone/history451 · licencia |
História oblasti, interval po intervale. | Denne. |
/api/v1/prices/:zone/summary451 · licencia |
Priemer, minimum, maximum a kvantily podľa dňa, týždňa alebo mesiaca. | Denne. |
/api/v1/market/cheapest451 · licencia |
Oblasti s najnižšou priemernou cenou dňa. | Denne. |
/api/v1/market/expensive451 · licencia |
Oblasti s najvyššou priemernou cenou dňa. | Denne. |
/api/v1/market/spreads451 · licencia |
Rozdiel medzi najlacnejšou a najdrahšou hodinou, podľa oblasti. | Denne. |
/api/v1/market/cheapest-window451 · licencia |
Najlacnejšie súvislé N-hodinové okno v oblasti. | Denne. |
/api/v1/market/weekly451 · licencia |
Týždenná správa po uzavretí týždňa. | Týždenne. |
Prečo cenové koncové body odpovedajú kódom 451
Trhové údaje pochádzajú z platformy transparentnosti ENTSO-E. Zbierame ich a zobrazujeme na webe so zdrojom uvedeným pri každom čísle, ale ich redistribúcia cez API nie je to isté ako ich zobrazenie a podmienky opätovného použitia sme zatiaľ neoverili ani nezaregistrovali.
Dovtedy cenové koncové body vracajú 451 — kód pre „nedostupné z právnych dôvodov“ — namiesto toho, aby potichu dodávali niečo, na čo nemáme právo. Systém licencií funguje podľa zdroja, nie podľa krajiny, takže ich sprístupnenie nevyžaduje žiadnu zmenu kódu.
Pravidlá slušného správania
Limit požiadaviek neexistuje a boli by sme radi, keby nebol potrebný. Odpovede nesú hlavičku cache-control: rešpektujte ju a dostanete presne rovnaké čísla bez toho, aby ste sa pýtali dvakrát. Údaje v reálnom čase sa nemenia častejšie, ako ich prevádzkovateľ zverejňuje — jedna požiadavka za sekundu pre krajinu, ktorá zverejňuje raz za hodinu, neprinesie nič nové.
Ak údaje používate verejne, citujte pôvodný zdroj (prevádzkovateľa prenosovej sústavy alebo ENTSO-E), nie naše meno: my ich prenášame, nevytvárame ich.
Pozrite aj: Zdroje údajov · Metodika · Stav systému · llms.txt