API

Dane prosto z platformy

Ta sama warstwa, z której czytają strony serwisu. Bez klucza, bez rejestracji, JSON przez HTTP. Każda odpowiedź mówi, z jakiego źródła pochodzi, jakiego momentu dotyczy i jak świeże są dane.

System elektroenergetyczny w czasie rzeczywistym

Zapotrzebowanie, produkcja według źródeł i wymiana transgraniczna, tak jak publikują je operatorzy systemów przesyłowych. Otwarte.

Adres Co zwraca Częstotliwość
/api/v1/countries Wszystkie kraje na platformie, z ich obszarami i stanem pokrycia danymi. Zmienia się rzadko — gdy zmienia się rejestr.
/api/v1/countries/:iso2/latest Migawka kraju: zapotrzebowanie, produkcja według źródeł, saldo na granicach. Tak często, jak publikuje operator — od 10 sekund do godziny.
/api/v1/countries/:iso2/history Szereg czasowy dla jednego kraju, w wybranym zakresie. Ta sama częstotliwość co migawka.
/api/v1/europe/latest Suma europejska i każdy kraj, który do niej wchodzi. Jedna minuta.
/api/v1/status Stan zbierania danych: które źródło publikowało ostatnio i kiedy. Na bieżąco.
/api/v1/licenses Co platforma może robić z danymi każdego źródła. Gdy zmieniają się warunki źródła.
/api/v1/search Wyszukiwanie w krajach, obszarach i pojęciach. Na bieżąco.

Rynek dnia następnego

Ceny z aukcji na następny dzień, według obszarów rynkowych. Na razie zamknięte — poniżej wyjaśniamy dlaczego.

Adres Co zwraca Częstotliwość
/api/v1/prices/latest451 · licencja Najnowsza znana cena dla każdego obszaru. Raz dziennie, po aukcji.
/api/v1/prices/zones451 · licencja Obszary rynkowe, z ich strefą czasową i walutą. Zmienia się rzadko.
/api/v1/prices/date451 · licencja Wszystkie obszary dla wybranego dnia dostawy. Codziennie.
/api/v1/prices/country/:iso2451 · licencja Ceny kraju, dla każdego z jego obszarów. Codziennie.
/api/v1/prices/:zone/history451 · licencja Historia obszaru, interwał po interwale. Codziennie.
/api/v1/prices/:zone/summary451 · licencja Średnia, minimum, maksimum i kwantyle według dnia, tygodnia lub miesiąca. Codziennie.
/api/v1/market/cheapest451 · licencja Obszary z najniższą średnią ceną dnia. Codziennie.
/api/v1/market/expensive451 · licencja Obszary z najwyższą średnią ceną dnia. Codziennie.
/api/v1/market/spreads451 · licencja Różnica między najtańszą a najdroższą godziną, według obszarów. Codziennie.
/api/v1/market/cheapest-window451 · licencja Najtańsze ciągłe okno N-godzinne w obszarze. Codziennie.
/api/v1/market/weekly451 · licencja Raport tygodniowy, po zamknięciu tygodnia. Co tydzień.

Dlaczego ścieżki cenowe odpowiadają kodem 451

Dane rynkowe pochodzą z platformy przejrzystości ENTSO-E. Zbieramy je i pokazujemy w serwisie ze źródłem podanym przy każdej liczbie, ale redystrybucja przez API to nie to samo co wyświetlanie, a warunki ponownego wykorzystania nie zostały jeszcze przez nas zweryfikowane i zarejestrowane.

Do tego czasu ścieżki cenowe zwracają 451 — kod oznaczający „niedostępne z powodów prawnych” — zamiast po cichu dostarczać coś, do czego nie mamy prawa. System licencji działa według źródła, a nie według kraju, więc ich otwarcie nie wymaga żadnej zmiany w kodzie.

Zasady dobrego zachowania

Nie ma limitu zapytań i chcielibyśmy, żeby nie był potrzebny. Odpowiedzi zawierają cache-control: szanuj go, a dostaniesz dokładnie te same liczby bez pytania dwa razy. Dane w czasie rzeczywistym nie zmieniają się częściej, niż publikuje je operator — jedno zapytanie na sekundę o kraj, który publikuje co godzinę, nie przynosi niczego nowego.

Jeśli publicznie korzystasz z danych, podawaj oryginalne źródło (operatora systemu przesyłowego lub ENTSO-E), a nie naszą nazwę: my je przenosimy, a nie wytwarzamy.

Zobacz też: Źródła danych · Metodologia · Stan systemu · llms.txt