API

Az adatok közvetlenül a platformról

Ugyanaz a réteg, amelyet a webhely saját oldalai olvasnak. Kulcs és regisztráció nélkül, JSON HTTP-n keresztül. Minden válasz megmondja, melyik forrásból származik, melyik pillanatra vonatkozik és mennyire friss.

A villamosenergia-rendszer valós időben

Fogyasztás, forrásonkénti termelés és határkeresztező cserék, ahogy az átviteli rendszerirányítók közzéteszik. Nyitott.

Cím Mit ad vissza Gyakoriság
/api/v1/countries A platform minden országa, övezeteivel és lefedettségi állapotával. Ritkán változik — amikor a nyilvántartás változik.
/api/v1/countries/:iso2/latest Egy ország pillanatképe: fogyasztás, forrásonkénti termelés, határegyenleg. Olyan gyakran, ahogy az üzemeltetője publikál — 10 másodperctől egy óráig.
/api/v1/countries/:iso2/history Egy ország idősora, választott időtartományra. Ugyanaz a gyakoriság, mint a pillanatképé.
/api/v1/europe/latest Az európai összesítés és minden benne szereplő ország. Egy perc.
/api/v1/status Az adatgyűjtés állapota: melyik forrás publikált utoljára, és mikor. Folyamatos.
/api/v1/licenses Mit tehet a platform az egyes források adataival. Amikor egy forrás feltételei változnak.
/api/v1/search Keresés országok, övezetek és fogalmak között. Folyamatos.

A másnapi piac

A következő napra aukción kialakult árak, ajánlattételi övezetenként. Egyelőre zárva — lásd lent, miért.

Cím Mit ad vissza Gyakoriság
/api/v1/prices/latest451 · licenc Minden övezet legutolsó ismert ára. Naponta egyszer, az aukció után.
/api/v1/prices/zones451 · licenc Az ajánlattételi övezetek, mindegyik időzónájával és pénznemével. Ritkán változik.
/api/v1/prices/date451 · licenc Minden övezet, egy választott szállítási napra. Naponta.
/api/v1/prices/country/:iso2451 · licenc Egy ország árai, minden övezetére. Naponta.
/api/v1/prices/:zone/history451 · licenc Egy övezet előzményei, intervallumonként. Naponta.
/api/v1/prices/:zone/summary451 · licenc Átlag, minimum, maximum és kvantilisek napra, hétre vagy hónapra. Naponta.
/api/v1/market/cheapest451 · licenc A nap legalacsonyabb átlagárú övezetei. Naponta.
/api/v1/market/expensive451 · licenc A nap legmagasabb átlagárú övezetei. Naponta.
/api/v1/market/spreads451 · licenc A legolcsóbb és a legdrágább óra közötti különbség, övezetenként. Naponta.
/api/v1/market/cheapest-window451 · licenc A legolcsóbb összefüggő N órás időablak egy övezetben. Naponta.
/api/v1/market/weekly451 · licenc A heti jelentés, amint a hét lezárult. Hetente.

Miért válaszolnak az árútvonalak 451-gyel

A piaci adatok az ENTSO-E átláthatósági platformról származnak. Összegyűjtjük őket, és a webhelyen minden szám mellett a forrással együtt mutatjuk, de API-n keresztül továbbterjeszteni nem ugyanaz, mint megjeleníteni, a továbbfelhasználási feltételeket pedig még nem ellenőriztük és nem rögzítettük.

Addig az árútvonalak a 451 kódot adják vissza — ez a „jogi okokból nem elérhető” jelzés —, ahelyett hogy csendben kiadnának valamit, amire nincs jogunk. A licenckezelés forrásonként működik, nem országonként, így megnyitásukhoz nem kell a kódot módosítani.

Az illendő használat szabályai

Nincs lekérdezési korlát, és szeretnénk, ha nem is kellene bevezetni. A válaszok cache-control fejlécet tartalmaznak: tartsa tiszteletben, és pontosan ugyanazokat a számokat kapja, kétszeri lekérdezés nélkül. A valós idejű adatok nem változnak gyakrabban, mint ahogy az üzemeltetőjük publikál — másodpercenként egy lekérdezés egy óránként publikáló országra semmi újat nem hoz.

Ha nyilvánosan használja az adatokat, az eredeti forrást (az átviteli rendszerirányítót vagy az ENTSO-E-t) nevezze meg, ne minket: mi szállítjuk, nem mi állítjuk elő őket.

Lásd még: Adatforrások · Módszertan · Rendszerállapot · llms.txt