API

Podaci, izravno s platforme

Isti sloj koji čitaju i stranice ovog webmjesta. Bez ključa, bez registracije, JSON preko HTTP-a. Svaki odgovor navodi iz kojeg izvora dolazi, na koji se trenutak odnosi i koliko je svjež.

Elektroenergetski sustav, u stvarnom vremenu

Potrošnja, proizvodnja po izvorima i prekogranična razmjena, kako ih objavljuju operatori prijenosnih sustava. Otvoreno.

Adresa Što vraća Učestalost
/api/v1/countries Sve zemlje na platformi, s njihovim zonama i stanjem pokrivenosti. Rijetko se mijenja — kad se promijeni registar.
/api/v1/countries/:iso2/latest Snimka stanja jedne zemlje: potrošnja, proizvodnja po izvorima, saldo na granicama. Onoliko često koliko objavljuje njezin operator — od 10 sekundi do jednog sata.
/api/v1/countries/:iso2/history Vremenski niz za jednu zemlju, u odabranom rasponu. Ista učestalost kao snimka stanja.
/api/v1/europe/latest Europski zbroj i sve zemlje koje ulaze u njega. Jedna minuta.
/api/v1/status Stanje prikupljanja: koji je izvor zadnji objavio i kada. Kontinuirano.
/api/v1/licenses Što platforma smije raditi s podacima svakog izvora. Kad se promijene uvjeti nekog izvora.
/api/v1/search Pretraživanje zemalja, zona i pojmova. Kontinuirano.

Tržište dan unaprijed

Cijene s dražbe za sljedeći dan, po zoni trgovanja. Zasad zatvoreno — razlog pogledajte u nastavku.

Adresa Što vraća Učestalost
/api/v1/prices/latest451 · licencija Zadnja poznata cijena za svaku zonu. Jednom dnevno, nakon dražbe.
/api/v1/prices/zones451 · licencija Zone trgovanja, s vremenskom zonom i valutom svake od njih. Rijetko se mijenja.
/api/v1/prices/date451 · licencija Sve zone, za odabrani dan isporuke. Dnevno.
/api/v1/prices/country/:iso2451 · licencija Cijene jedne zemlje, za svaku od njezinih zona. Dnevno.
/api/v1/prices/:zone/history451 · licencija Povijest jedne zone, interval po interval. Dnevno.
/api/v1/prices/:zone/summary451 · licencija Prosjek, minimum, maksimum i kvantili po danu, tjednu ili mjesecu. Dnevno.
/api/v1/market/cheapest451 · licencija Zone s najnižom prosječnom cijenom dana. Dnevno.
/api/v1/market/expensive451 · licencija Zone s najvišom prosječnom cijenom dana. Dnevno.
/api/v1/market/spreads451 · licencija Razlika između najjeftinijeg i najskupljeg sata, po zoni. Dnevno.
/api/v1/market/cheapest-window451 · licencija Najjeftiniji neprekinuti prozor od N sati u zoni. Dnevno.
/api/v1/market/weekly451 · licencija Tjedno izvješće, nakon što tjedan završi. Tjedno.

Zašto rute s cijenama 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 redistribucija putem API-ja nije isto što i prikaz, a uvjete ponovne uporabe još nismo provjerili ni evidentirali.

Do tada rute s cijenama vraćaju 451 — kod za „nedostupno iz pravnih razloga“ — umjesto da potiho isporučuju nešto na što nemamo pravo. Sustav licencija radi po izvoru, a ne po zemlji, pa njihovo otvaranje ne zahtijeva nikakvu promjenu koda.

Pravila lijepog ponašanja

Nema ograničenja broja zahtjeva i voljeli bismo da ga ne mora biti. Odgovori nose cache-control: poštujte ga i dobit ćete točno iste brojke bez dvostrukog traženja. Podaci u stvarnom vremenu ne mijenjaju se češće nego što ih operator objavljuje — jedan zahtjev u sekundi za zemlju koja objavljuje svaki sat ne donosi ništa novo.

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

Vidi i: Izvori podataka · Metodologija · Stanje sustava · llms.txt