API

Podaci, direktno s platforme

Isti sloj koji čitaju i stranice same platforme. Bez ključa, bez registracije, JSON preko HTTP-a. Svaki odgovor kaže iz kojeg izvora potiče, na koji se trenutak odnosi i koliko je svjež.

Elektroenergetski sistem, u stvarnom vremenu

Potrošnja, proizvodnja po izvorima i prekogranična razmjena, onako kako ih objavljuju operatori prenosnih sistema. Otvoreno.

Adresa Šta vraća Učestalost
/api/v1/countries Sve zemlje na platformi, s njihovim zonama i statusom pokrivenosti. Rijetko se mijenja — kada se promijeni registar.
/api/v1/countries/:iso2/latest Trenutni snimak zemlje: potrošnja, proizvodnja po izvorima, bilans na granicama. Onoliko često koliko objavljuje njen operator — od 10 sekundi do jednog sata.
/api/v1/countries/:iso2/history Vremenska serija za jednu zemlju, za odabrani raspon. Ista učestalost kao za snimak.
/api/v1/europe/latest Evropski zbir i svaka zemlja koja ulazi u njega. Jedna minuta.
/api/v1/status Stanje prikupljanja: koji je izvor posljednji objavio podatke i kada. Neprekidno.
/api/v1/licenses Šta platforma smije raditi s podacima svakog izvora. Kada se promijene uslovi nekog izvora.
/api/v1/search Pretraga zemalja, zona i pojmova. Neprekidno.

Tržište dan unaprijed

Cijene s aukcije za sljedeći dan, po zoni trgovanja. Zasad zatvoreno — razlog je objašnjen u nastavku.

Adresa Šta vraća Učestalost
/api/v1/prices/latest451 · licenca Posljednja poznata cijena za svaku zonu. Jednom dnevno, nakon aukcije.
/api/v1/prices/zones451 · licenca Zone trgovanja, s vremenskom zonom i valutom svake od njih. Rijetko se mijenja.
/api/v1/prices/date451 · licenca Sve zone, za odabrani dan isporuke. Dnevno.
/api/v1/prices/country/:iso2451 · licenca Cijene jedne zemlje, za svaku od njenih zona. Dnevno.
/api/v1/prices/:zone/history451 · licenca Historija zone, interval po interval. Dnevno.
/api/v1/prices/:zone/summary451 · licenca Prosjek, minimum, maksimum i kvantili po danu, sedmici ili mjesecu. Dnevno.
/api/v1/market/cheapest451 · licenca Zone s najnižom prosječnom cijenom dana. Dnevno.
/api/v1/market/expensive451 · licenca Zone s najvišom prosječnom cijenom dana. Dnevno.
/api/v1/market/spreads451 · licenca Razlika između najjeftinijeg i najskupljeg sata, po zoni. Dnevno.
/api/v1/market/cheapest-window451 · licenca Najjeftiniji neprekidni prozor od N sati u zoni. Dnevno.
/api/v1/market/weekly451 · licenca Sedmični izvještaj, nakon što se sedmica zatvori. Sedmično.

Zašto rute za cijene odgovaraju kodom 451

Tržišni podaci dolaze s platforme za transparentnost ENTSO-E. Prikupljamo ih i prikazujemo na stranici s izvorom navedenim uz svaku brojku, ali njihova redistribucija putem API-ja nije isto što i prikazivanje, a uslove ponovne upotrebe još nismo provjerili i evidentirali.

Do tada rute za cijene vraćaju 451 — kod za „nedostupno iz pravnih razloga“ — umjesto da tiho isporučuju nešto na šta nemamo pravo. Sistem licenci radi po izvoru, a ne po zemlji, pa njihovo otvaranje ne zahtijeva nikakvu izmjenu koda.

Pravila lijepog ponašanja

Ograničenja broja zahtjeva nema, i voljeli bismo da ne mora postojati. Odgovori nose cache-control: poštujte ga i dobit ćete potpuno iste brojke bez dvostrukog pitanja. Podaci u stvarnom vremenu ne mijenjaju se češće nego što ih operator objavljuje — jedan zahtjev u sekundi za zemlju koja objavljuje po satu ne donosi ništa novo.

Ako podatke koristite javno, navedite izvorni izvor (operatora prenosnog sistema ili ENTSO-E), a ne naše ime: mi ih prenosimo, ne proizvodimo.

Pogledajte i: Izvori podataka · Metodologija · Stanje sistema · llms.txt