API

Na sonraí, díreach ón ardán

An tsraith chéanna a léann leathanaigh an tsuímh féin. Gan eochair, gan chlárú, JSON thar HTTP. Insíonn gach freagra cén fhoinse óna dtáinig sé, cén nóiméad lena mbaineann sé agus cé chomh húr is atá sé.

An córas cumhachta, i bhfíor-am

Éileamh, giniúint de réir foinse agus malartuithe trasteorann, mar a fhoilsíonn na hoibreoirí tarchurtha iad. Oscailte.

Seoladh Toradh Minicíocht
/api/v1/countries Gach tír ar an ardán, lena criosanna agus a stádas clúdaigh. Is annamh a athraíonn sé — nuair a athraíonn an clár.
/api/v1/countries/:iso2/latest Pictiúr reatha de thír: éileamh, giniúint de réir foinse, comhardú ag na teorainneacha. Chomh minic agus a fhoilsíonn a hoibreoir — ó 10 soicind go huair an chloig.
/api/v1/countries/:iso2/history Sraith ama do thír amháin, thar raon roghnaithe. An mhinicíocht chéanna leis an bpictiúr reatha.
/api/v1/europe/latest Iomlán na hEorpa agus gach tír a áirítear ann. Nóiméad amháin.
/api/v1/status Staid an bhailiúcháin: cén fhoinse a d'fhoilsigh go deireanach, agus cathain. Leanúnach.
/api/v1/licenses An méid a bhfuil cead ag an ardán a dhéanamh le sonraí gach foinse. Nuair a athraíonn téarmaí foinse.
/api/v1/search Cuardach ar fud tíortha, criosanna agus téarmaí. Leanúnach.

An margadh lá roimh ré

Na praghsanna a ceantáladh don lá dár gcionn, de réir creasa tairisceana. Dúnta faoi láthair — féach thíos cén fáth.

Seoladh Toradh Minicíocht
/api/v1/prices/latest451 · ceadúnas An praghas is déanaí atá ar eolas do gach crios. Uair sa lá, tar éis an cheaint.
/api/v1/prices/zones451 · ceadúnas Na criosanna tairisceana, le crios ama agus airgeadra gach ceann acu. Is annamh a athraíonn sé.
/api/v1/prices/date451 · ceadúnas Gach crios, do lá seachadta roghnaithe. Laethúil.
/api/v1/prices/country/:iso2451 · ceadúnas Praghsanna tíre, do gach ceann dá criosanna. Laethúil.
/api/v1/prices/:zone/history451 · ceadúnas Stair creasa, eatramh ar eatramh. Laethúil.
/api/v1/prices/:zone/summary451 · ceadúnas Meán, íosmhéid, uasmhéid agus cainníochtaí de réir lae, seachtaine nó míosa. Laethúil.
/api/v1/market/cheapest451 · ceadúnas Na criosanna leis an meánphraghas is ísle sa lá. Laethúil.
/api/v1/market/expensive451 · ceadúnas Na criosanna leis an meánphraghas is airde sa lá. Laethúil.
/api/v1/market/spreads451 · ceadúnas An difríocht idir an uair is saoire agus an uair is daoire, de réir creasa. Laethúil.
/api/v1/market/cheapest-window451 · ceadúnas An fhuinneog leanúnach N uair an chloig is saoire i gcrios. Laethúil.
/api/v1/market/weekly451 · ceadúnas An tuarascáil sheachtainiúil, nuair atá an tseachtain dúnta. Seachtainiúil.

Cén fáth a bhfreagraíonn bealaí na bpraghsanna le 451

Tagann sonraí an mhargaidh ó ardán trédhearcachta ENTSO-E. Bailímid iad agus taispeánaimid ar an suíomh iad agus an fhoinse scríofa in aice le gach figiúr, ach ní hionann iad a athdháileadh trí API agus iad a thaispeáint, agus níl na téarmaí athúsáide deimhnithe ná cláraithe againn fós.

Go dtí sin, tugann bealaí na bpraghsanna 451 ar ais — an cód do “níl ar fáil ar chúiseanna dlíthiúla” — seachas rud a sheachadadh go ciúin nach bhfuil de cheart againn a sheachadadh. Oibríonn an córas ceadúnaithe in aghaidh na foinse, ní in aghaidh na tíre, mar sin ní gá aon athrú cóid chun iad a oscailt.

Rialacha dea-iompair

Níl teorainn iarratas ann, agus ba mhaith linn nach mbeadh gá le ceann. Tá cache-control sna freagraí: tabhair aird air agus gheobhaidh tú na figiúirí céanna díreach gan iarraidh faoi dhó. Ní athraíonn sonraí fíor-ama níos minice ná mar a fhoilsíonn a n-oibreoir iad — ní thugann iarratas amháin sa soicind do thír a fhoilsíonn gach uair aon ní nua.

Má úsáideann tú na sonraí go poiblí, luaigh an fhoinse bhunaidh (an t-oibreoir tarchurtha nó ENTSO-E), ní ár n-ainm-ne: iompraímid iad, ní tháirgimid iad.

Féach freisin: Foinsí sonraí · Modheolaíocht · Stádas an chórais · llms.txt