Duomenys tiesiai iš platformos
Tas pats sluoksnis, kurį skaito pačios svetainės puslapiai. Be rakto, be registracijos, JSON per HTTP. Kiekviename atsakyme nurodyta, iš kokio šaltinio jis gautas, kokį momentą apima ir kiek jis šviežias.
Elektros energetikos sistema realiuoju laiku
Suvartojimas, gamyba pagal šaltinį ir tarpvalstybiniai mainai, kaip juos skelbia perdavimo sistemos operatoriai. Atvira.
| Adresas | Ką grąžina | Dažnumas |
|---|---|---|
/api/v1/countries |
Visos platformos šalys su jų zonomis ir aprėpties būsena. | Keičiasi retai – kai pasikeičia registras. |
/api/v1/countries/:iso2/latest |
Šalies momentinė būklė: suvartojimas, gamyba pagal šaltinį, balansas ties sienomis. | Taip dažnai, kaip skelbia jos operatorius – nuo 10 sekundžių iki valandos. |
/api/v1/countries/:iso2/history |
Vienos šalies laiko eilutė pasirinktu intervalu. | Toks pat dažnumas kaip momentinės būklės. |
/api/v1/europe/latest |
Europos suma ir visos į ją įtrauktos šalys. | Viena minutė. |
/api/v1/status |
Duomenų rinkimo būsena: kuris šaltinis paskelbė paskutinis ir kada. | Nuolat. |
/api/v1/licenses |
Ką platforma gali daryti su kiekvieno šaltinio duomenimis. | Kai pasikeičia šaltinio sąlygos. |
/api/v1/search |
Paieška tarp šalių, zonų ir terminų. | Nuolat. |
Kitos paros rinka
Kitai parai aukcione nustatytos kainos pagal prekybos zoną. Kol kas uždaryta – žr. žemiau, kodėl.
| Adresas | Ką grąžina | Dažnumas |
|---|---|---|
/api/v1/prices/latest451 · licencija |
Naujausia žinoma kiekvienos zonos kaina. | Kartą per dieną, po aukciono. |
/api/v1/prices/zones451 · licencija |
Prekybos zonos su kiekvienos laiko juosta ir valiuta. | Keičiasi retai. |
/api/v1/prices/date451 · licencija |
Visos zonos pasirinktai tiekimo parai. | Kasdien. |
/api/v1/prices/country/:iso2451 · licencija |
Šalies kainos kiekvienai jos zonai. | Kasdien. |
/api/v1/prices/:zone/history451 · licencija |
Zonos istorija, intervalas po intervalo. | Kasdien. |
/api/v1/prices/:zone/summary451 · licencija |
Vidurkis, minimumas, maksimumas ir kvantiliai pagal dieną, savaitę ar mėnesį. | Kasdien. |
/api/v1/market/cheapest451 · licencija |
Zonos su mažiausia dienos vidutine kaina. | Kasdien. |
/api/v1/market/expensive451 · licencija |
Zonos su didžiausia dienos vidutine kaina. | Kasdien. |
/api/v1/market/spreads451 · licencija |
Skirtumas tarp pigiausios ir brangiausios valandos pagal zoną. | Kasdien. |
/api/v1/market/cheapest-window451 · licencija |
Pigiausias nenutrūkstamas N valandų langas zonoje. | Kasdien. |
/api/v1/market/weekly451 · licencija |
Savaitės ataskaita, kai savaitė pasibaigia. | Kas savaitę. |
Kodėl kainų maršrutai atsako kodu 451
Rinkos duomenys gaunami iš ENTSO-E skaidrumo platformos. Juos renkame ir rodome svetainėje, prie kiekvieno skaičiaus nurodydami šaltinį, bet platinti juos per API nėra tas pat, kas juos rodyti, o pakartotinio naudojimo sąlygų mes dar nesame patikrinę ir užregistravę.
Iki tol kainų maršrutai grąžina 451 – kodą, reiškiantį „neprieinama dėl teisinių priežasčių“, – užuot tyliai pateikę tai, ko neturime teisės pateikti. Licencijavimo sistema veikia pagal šaltinį, o ne pagal šalį, todėl joms atverti nereikia keisti kodo.
Gero elgesio taisyklės
Užklausų limito nėra, ir norėtume, kad jo neprireiktų. Atsakymuose yra cache-control: jo laikykitės ir gausite lygiai tuos pačius skaičius, neklausdami du kartus. Duomenys realiuoju laiku nesikeičia dažniau, nei juos skelbia operatorius, – viena užklausa per sekundę šaliai, kuri skelbia kas valandą, nieko naujo neduoda.
Jei duomenis naudojate viešai, nurodykite pirminį šaltinį (perdavimo sistemos operatorių arba ENTSO-E), o ne mūsų pavadinimą: mes juos pervežame, o ne gaminame.
Taip pat žr.: Duomenų šaltiniai · Metodika · Sistemos būsena · llms.txt