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