API

Подаци, директно са платформе

Исти слој који читају странице самог сајта. Без кључа, без регистрације, JSON преко HTTP-а. Сваки одговор наводи из ког извора потиче, на који се тренутак односи и колико је свеж.

Електроенергетски систем, у реалном времену

Потрошња, производња по изворима и прекогранична размена, онако како их објављују оператори преносних система. Отворено.

Адреса Шта враћа Учесталост
/api/v1/countries Свака земља на платформи, са својим зонама и статусом покривености. Ретко се мења — када се промени регистар.
/api/v1/countries/:iso2/latest Тренутни преглед земље: потрошња, производња по изворима, салдо на границама. Онолико често колико објављује њен оператор — од 10 секунди до једног сата.
/api/v1/countries/:iso2/history Временска серија за једну земљу, у изабраном распону. Иста учесталост као за тренутни преглед.
/api/v1/europe/latest Европски збир и свака земља која улази у њега. Један минут.
/api/v1/status Стање прикупљања: који је извор последњи објавио и када. Непрекидно.
/api/v1/licenses Шта платформа сме да ради са подацима сваког извора. Када се промене услови неког извора.
/api/v1/search Претрага по земљама, зонама и појмовима. Непрекидно.

Тржиште дан унапред

Цене са аукције за наредни дан, по зони трговања. Засад затворено — зашто, погледајте испод.

Адреса Шта враћа Учесталост
/api/v1/prices/latest451 · лиценца Последња позната цена за сваку зону. Једном дневно, после аукције.
/api/v1/prices/zones451 · лиценца Зоне трговања, са временском зоном и валутом сваке од њих. Ретко се мења.
/api/v1/prices/date451 · лиценца Све зоне, за изабрани дан испоруке. Дневно.
/api/v1/prices/country/:iso2451 · лиценца Цене једне земље, за сваку од њених зона. Дневно.
/api/v1/prices/:zone/history451 · лиценца Историја зоне, интервал по интервал. Дневно.
/api/v1/prices/:zone/summary451 · лиценца Просек, минимум, максимум и квантили по дану, недељи или месецу. Дневно.
/api/v1/market/cheapest451 · лиценца Зоне са најнижом просечном ценом дана. Дневно.
/api/v1/market/expensive451 · лиценца Зоне са највишом просечном ценом дана. Дневно.
/api/v1/market/spreads451 · лиценца Разлика између најјефтинијег и најскупљег сата, по зони. Дневно.
/api/v1/market/cheapest-window451 · лиценца Најјефтинији непрекидни термин од N сати у зони. Дневно.
/api/v1/market/weekly451 · лиценца Недељни извештај, након што се недеља заврши. Недељно.

Зашто руте за цене одговарају кодом 451

Тржишни подаци потичу са платформе за транспарентност ENTSO-E. Прикупљамо их и приказујемо на сајту уз извор наведен поред сваке бројке, али даља дистрибуција преко API-ја није исто што и приказивање, а услове поновне употребе још нисмо проверили и евидентирали.

Дотле руте за цене враћају 451 — код за „недоступно из правних разлога“ — уместо да тихо испоручују нешто што немамо право да испоручимо. Систем лиценци ради по извору, а не по земљи, па њихово отварање не захтева никакву измену кода.

Правила лепог понашања

Нема ограничења броја захтева и волели бисмо да не мора да га буде. Одговори носе заглавље cache-control: поштујте га и добићете потпуно исте бројке без двоструког питања. Подаци у реалном времену не мењају се чешће него што их оператор објављује — један захтев у секунди за земљу која објављује на сат не доноси ништа ново.

Ако податке користите јавно, наведите првобитни извор (оператора преносног система или ENTSO-E), а не наше име: ми их преносимо, не производимо их.

Погледајте и: Извори података · Методологија · Статус система · llms.txt