Данните, направо от платформата
Същият слой, който четат страниците на самия сайт. Без ключ, без регистрация, 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