API

Dati tieši no platformas

Tas pats slānis, ko lasa pašas vietnes lapas. Bez atslēgas, bez reģistrācijas, JSON pa HTTP. Katra atbilde norāda, no kāda avota tā nāk, uz kuru brīdi attiecas un cik svaiga tā ir.

Energosistēma reāllaikā

Patēriņš, ražošana pa avotiem un pārrobežu apmaiņa, kā tos publicē pārvades sistēmu operatori. Atvērts.

Adrese Ko atgriež Biežums
/api/v1/countries Visas platformas valstis ar to zonām un pārklājuma statusu. Mainās reti — kad mainās reģistrs.
/api/v1/countries/:iso2/latest Valsts momentuzņēmums: patēriņš, ražošana pa avotiem, pārrobežu bilance. Tik bieži, cik publicē tās operators — no 10 sekundēm līdz stundai.
/api/v1/countries/:iso2/history Vienas valsts laikrinda izvēlētā periodā. Tāds pats biežums kā momentuzņēmumam.
/api/v1/europe/latest Eiropas kopsumma un katra valsts, kas tajā ietilpst. Viena minūte.
/api/v1/status Datu vākšanas stāvoklis: kurš avots publicēja pēdējais un kad. Nepārtraukti.
/api/v1/licenses Ko platforma drīkst darīt ar katra avota datiem. Kad mainās avota noteikumi.
/api/v1/search Meklēšana valstīs, zonās un terminos. Nepārtraukti.

Nākamās dienas tirgus

Nākamajai dienai izsolītās cenas pa tirdzniecības zonām. Pagaidām slēgts — skatiet zemāk, kāpēc.

Adrese Ko atgriež Biežums
/api/v1/prices/latest451 · licence Jaunākā zināmā cena katrai zonai. Reizi dienā, pēc izsoles.
/api/v1/prices/zones451 · licence Tirdzniecības zonas ar katras zonas laika joslu un valūtu. Mainās reti.
/api/v1/prices/date451 · licence Visas zonas izvēlētajai piegādes dienai. Katru dienu.
/api/v1/prices/country/:iso2451 · licence Valsts cenas katrā tās zonā. Katru dienu.
/api/v1/prices/:zone/history451 · licence Zonas vēsture intervālu pa intervālam. Katru dienu.
/api/v1/prices/:zone/summary451 · licence Vidējā vērtība, minimums, maksimums un kvantiles pa dienām, nedēļām vai mēnešiem. Katru dienu.
/api/v1/market/cheapest451 · licence Zonas ar zemāko dienas vidējo cenu. Katru dienu.
/api/v1/market/expensive451 · licence Zonas ar augstāko dienas vidējo cenu. Katru dienu.
/api/v1/market/spreads451 · licence Starpība starp lētāko un dārgāko stundu pa zonām. Katru dienu.
/api/v1/market/cheapest-window451 · licence Lētākais nepārtrauktais N stundu logs zonā. Katru dienu.
/api/v1/market/weekly451 · licence Iknedēļas pārskats pēc nedēļas noslēgšanās. Katru nedēļu.

Kāpēc cenu maršruti atbild ar 451

Tirgus dati nāk no ENTSO-E pārredzamības platformas. Mēs tos vācam un rādām vietnē, blakus katram skaitlim norādot avotu, taču to izplatīšana caur API nav tas pats, kas to attēlošana, un atkalizmantošanas noteikumus mēs vēl neesam pārbaudījuši un reģistrējuši.

Līdz tam cenu maršruti atgriež 451 (kods nozīmē „nav pieejams juridisku iemeslu dēļ“), nevis klusi piegādā kaut ko, ko mums nav tiesību piegādāt. Licencēšanas sistēma darbojas pa avotiem, nevis pa valstīm, tāpēc to atvēršanai nav vajadzīgas koda izmaiņas.

Labas uzvedības noteikumi

Pieprasījumu limita nav, un mēs vēlētos, lai tas arī nebūtu vajadzīgs. Atbildēs ir cache-control: ievērojiet to, un jūs saņemsiet tieši tos pašus skaitļus, neprasot divreiz. Reāllaika dati nemainās biežāk, nekā tos publicē operators — viens pieprasījums sekundē par valsti, kas publicē reizi stundā, neko jaunu nedod.

Ja datus izmantojat publiski, atsaucieties uz sākotnējo avotu (pārvades sistēmas operatoru vai ENTSO-E), nevis uz mūsu nosaukumu: mēs datus pārvadājam, nevis radām.

Skatīt arī: Datu avoti · Metodoloģija · Sistēmas statuss · llms.txt