API

Të dhënat, drejt nga platforma

E njëjta shtresë që lexojnë faqet e vetë sajtit. Pa çelës, pa regjistrim, JSON mbi HTTP. Çdo përgjigje tregon nga cili burim vjen, cilit çast i referohet dhe sa e freskët është.

Sistemi energjetik, në kohë reale

Konsumi, prodhimi sipas burimit dhe shkëmbimet ndërkufitare, siç i publikojnë operatorët e transmetimit. E hapur.

Adresa Çfarë kthen Ritmi
/api/v1/countries Çdo vend në platformë, me zonat e tij dhe statusin e mbulimit. Ndryshon rrallë — kur ndryshon regjistri.
/api/v1/countries/:iso2/latest Pamja e çastit e një vendi: konsumi, prodhimi sipas burimit, bilanci në kufi. Aq shpesh sa publikon operatori i tij — nga 10 sekonda deri në një orë.
/api/v1/countries/:iso2/history Seri kohore për një vend, për një interval të zgjedhur. I njëjti ritëm si pamja e çastit.
/api/v1/europe/latest Totali evropian dhe çdo vend që hyn në të. Një minutë.
/api/v1/status Gjendja e mbledhjes: cili burim publikoi i fundit dhe kur. E vazhdueshme.
/api/v1/licenses Çfarë i lejohet platformës të bëjë me të dhënat e secilit burim. Kur ndryshojnë kushtet e një burimi.
/api/v1/search Kërkim në vende, zona dhe terma. E vazhdueshme.

Tregu i ditës në avancë

Çmimet e ankanduara për ditën pasardhëse, sipas zonës së ofertave. E mbyllur për momentin — shikoni më poshtë pse.

Adresa Çfarë kthen Ritmi
/api/v1/prices/latest451 · licencë Çmimi i fundit i njohur për çdo zonë. Një herë në ditë, pas ankandit.
/api/v1/prices/zones451 · licencë Zonat e ofertave, me zonën kohore dhe monedhën e secilës. Ndryshon rrallë.
/api/v1/prices/date451 · licencë Të gjitha zonat, për një ditë dorëzimi të zgjedhur. Çdo ditë.
/api/v1/prices/country/:iso2451 · licencë Çmimet e një vendi, për secilën nga zonat e tij. Çdo ditë.
/api/v1/prices/:zone/history451 · licencë Historiku i një zone, interval pas intervali. Çdo ditë.
/api/v1/prices/:zone/summary451 · licencë Mesatarja, minimumi, maksimumi dhe kuantilet sipas ditës, javës ose muajit. Çdo ditë.
/api/v1/market/cheapest451 · licencë Zonat me çmimin mesatar më të ulët të ditës. Çdo ditë.
/api/v1/market/expensive451 · licencë Zonat me çmimin mesatar më të lartë të ditës. Çdo ditë.
/api/v1/market/spreads451 · licencë Diferenca mes orës më të lirë dhe orës më të shtrenjtë, sipas zonës. Çdo ditë.
/api/v1/market/cheapest-window451 · licencë Dritarja më e lirë e vazhdueshme prej N orësh në një zonë. Çdo ditë.
/api/v1/market/weekly451 · licencë Raporti javor, pasi të jetë mbyllur java. Çdo javë.

Pse rrugët e çmimeve përgjigjen me 451

Të dhënat e tregut vijnë nga platforma e transparencës ENTSO-E. I mbledhim dhe i shfaqim në faqe me burimin të shkruar pranë çdo shifre, por rishpërndarja e tyre përmes një API-je nuk është e njëjtë me shfaqjen, dhe kushtet e ripërdorimit nuk janë ende të verifikuara dhe të regjistruara nga ne.

Deri atëherë, rrugët e çmimeve kthejnë 451 — kodi për „i padisponueshëm për arsye ligjore“ — në vend që të japin në heshtje diçka që nuk kemi të drejtë ta japim. Sistemi i licencave funksionon sipas burimit, jo sipas vendit, kështu që hapja e tyre nuk kërkon asnjë ndryshim kodi.

Rregullat e sjelljes së mirë

Nuk ka kufi kërkesash, dhe do të donim që të mos kishte nevojë për një të tillë. Përgjigjet mbartin cache-control: respektojeni dhe do të merrni saktësisht të njëjtat shifra pa pyetur dy herë. Të dhënat në kohë reale nuk ndryshojnë më shpesh se sa publikon operatori i tyre — një kërkesë në sekondë për një vend që publikon çdo orë nuk sjell asgjë të re.

Nëse i përdorni të dhënat publikisht, citoni burimin origjinal (operatorin e transmetimit ose ENTSO-E), jo emrin tonë: ne i transportojmë, nuk i prodhojmë.

Shikoni edhe: Burimet e të dhënave · Metodologjia · Gjendja e sistemit · llms.txt