API

Id-data, direttament mill-pjattaforma

L-istess saff li jaqraw il-paġni tas-sit innifsu. L-ebda ċavetta, l-ebda reġistrazzjoni, JSON fuq HTTP. Kull tweġiba tgħid minn liema sors ġejja, għal liema mument tirreferi u kemm hi friska.

Is-sistema tal-elettriku, fil-ħin reali

Domanda, ġenerazzjoni skont is-sors u skambji transfruntiera, kif jippubblikawhom l-operaturi tat-trażmissjoni. Miftuħ.

Indirizz X’jirritorna Frekwenza
/api/v1/countries Kull pajjiż fil-pjattaforma, biż-żoni tiegħu u l-istatus tal-kopertura. Jinbidel rarament — meta jinbidel ir-reġistru.
/api/v1/countries/:iso2/latest Stampa ta’ pajjiż: domanda, ġenerazzjoni skont is-sors, bilanċ fil-fruntieri. Daqs kemm jippubblika l-operatur tiegħu — minn 10 sekondi sa siegħa.
/api/v1/countries/:iso2/history Serje kronoloġika għal pajjiż wieħed, fuq perjodu magħżul. L-istess frekwenza bħall-istampa.
/api/v1/europe/latest It-total Ewropew u kull pajjiż li jidħol fih. Minuta.
/api/v1/status L-istat tal-ġbir: liema sors ippubblika l-aħħar, u meta. Kontinwu.
/api/v1/licenses X’tista’ tagħmel il-pjattaforma bid-data ta’ kull sors. Meta jinbidlu t-termini ta’ sors.
/api/v1/search Tfittxija fost pajjiżi, żoni u termini. Kontinwu.

Is-suq ta’ ġurnata bil-quddiem

Il-prezzijiet irkantati għall-jum ta’ wara, skont iż-żona ta’ offerti. Magħluq għalissa — ara hawn taħt għaliex.

Indirizz X’jirritorna Frekwenza
/api/v1/prices/latest451 · liċenzja L-aħħar prezz magħruf għal kull żona. Darba kuljum, wara l-irkant.
/api/v1/prices/zones451 · liċenzja Iż-żoni ta’ offerti, biż-żona tal-ħin u l-munita ta’ kull waħda. Jinbidlu rarament.
/api/v1/prices/date451 · liċenzja Kull żona, għal jum tal-kunsinna magħżul. Kuljum.
/api/v1/prices/country/:iso2451 · liċenzja Il-prezzijiet ta’ pajjiż, għal kull waħda miż-żoni tiegħu. Kuljum.
/api/v1/prices/:zone/history451 · liċenzja L-istorja ta’ żona, intervall b’intervall. Kuljum.
/api/v1/prices/:zone/summary451 · liċenzja Medja, minimu, massimu u kwantili skont il-jum, il-ġimgħa jew ix-xahar. Kuljum.
/api/v1/market/cheapest451 · liċenzja Iż-żoni bl-inqas prezz medju tal-jum. Kuljum.
/api/v1/market/expensive451 · liċenzja Iż-żoni bl-ogħla prezz medju tal-jum. Kuljum.
/api/v1/market/spreads451 · liċenzja Id-differenza bejn l-irħas siegħa u l-aktar waħda għalja, skont iż-żona. Kuljum.
/api/v1/market/cheapest-window451 · liċenzja L-irħas perjodu kontinwu ta’ N sigħat f’żona. Kuljum.
/api/v1/market/weekly451 · liċenzja Ir-rapport ta’ kull ġimgħa, ladarba tkun għalqet il-ġimgħa. Kull ġimgħa.

Għaliex ir-rotot tal-prezzijiet iwieġbu b’451

Id-data tas-suq ġejja mill-pjattaforma tat-trasparenza tal-ENTSO-E. Aħna niġbruha u nuruha fis-sit bis-sors miktub ħdejn kull ċifra, iżda li titqassam mill-ġdid permezz ta’ API mhuwiex l-istess ħaġa bħal li tintwera, u t-termini tal-użu mill-ġdid għadhom mhumiex ivverifikati u reġistrati minna.

Sa dak iż-żmien, ir-rotot tal-prezzijiet jirritornaw 451 — il-kodiċi għal “mhux disponibbli għal raġunijiet legali” — minflok ma jwasslu bil-kwiet xi ħaġa li m’għandniex dritt inwasslu. Is-sistema tal-liċenzji taħdem għal kull sors, mhux għal kull pajjiż, għalhekk biex jinfetħu ma jeħtieġ l-ebda bidla fil-kodiċi.

Regoli ta’ mġiba tajba

M’hemmx limitu ta’ talbiet, u nixtiequ li ma jkunx hemm bżonn wieħed. It-tweġibiet għandhom cache-control: irrispettah u tirċievi eżattament l-istess ċifri mingħajr ma titlob darbtejn. Id-data fil-ħin reali ma tinbidilx aktar spiss milli jippubblika l-operatur tagħha — talba waħda kull sekonda għal pajjiż li jippubblika kull siegħa ma ġġib xejn ġdid.

Jekk tuża d-data pubblikament, iċċita s-sors oriġinali (l-operatur tat-trażmissjoni jew l-ENTSO-E), mhux isimna: aħna nġorruha, ma nipproduċuhiex.

Ara wkoll: Sorsi tad-data · Metodoloġija · Status tas-sistema · llms.txt