API

Gögnin, beint frá vettvanginum

Sama lag og síður vefsins sjálfs lesa. Enginn lykill, engin skráning, JSON yfir HTTP. Hvert svar segir úr hvaða gagnalind það kom, við hvaða tímapunkt það á og hversu nýtt það er.

Raforkukerfið, í rauntíma

Notkun, framleiðsla eftir orkugjöfum og viðskipti yfir landamæri, eins og flutningsfyrirtækin birta þau. Opið.

Slóð Hvað er skilað Tíðni
/api/v1/countries Öll lönd á vettvanginum, með svæðum sínum og stöðu gagnaþekju. Breytist sjaldan — þegar skráin breytist.
/api/v1/countries/:iso2/latest Staða lands: notkun, framleiðsla eftir orkugjöfum, jöfnuður á landamærum. Eins oft og rekstraraðilinn birtir — frá 10 sekúndum upp í klukkustund.
/api/v1/countries/:iso2/history Tímaröð fyrir eitt land, yfir valið tímabil. Sama tíðni og staðan.
/api/v1/europe/latest Evrópska samtalan og öll lönd sem eru í henni. Ein mínúta.
/api/v1/status Staða gagnasöfnunar: hvaða gagnalind birti síðast, og hvenær. Samfellt.
/api/v1/licenses Hvað vettvangurinn má gera við gögn hverrar gagnalindar. Þegar skilmálar gagnalindar breytast.
/api/v1/search Leit í löndum, svæðum og hugtökum. Samfellt.

Dagmarkaðurinn

Verðin sem boðin eru upp fyrir næsta dag, eftir tilboðssvæðum. Lokað í bili — sjá ástæðuna hér að neðan.

Slóð Hvað er skilað Tíðni
/api/v1/prices/latest451 · leyfi Síðasta þekkta verð fyrir hvert svæði. Einu sinni á dag, eftir uppboðið.
/api/v1/prices/zones451 · leyfi Tilboðssvæðin, hvert með sínu tímabelti og gjaldmiðli. Breytist sjaldan.
/api/v1/prices/date451 · leyfi Öll svæði, fyrir valinn afhendingardag. Daglega.
/api/v1/prices/country/:iso2451 · leyfi Verð lands, fyrir hvert svæði þess. Daglega.
/api/v1/prices/:zone/history451 · leyfi Saga svæðis, tímabil fyrir tímabil. Daglega.
/api/v1/prices/:zone/summary451 · leyfi Meðaltal, lágmark, hámark og fraktílar eftir degi, viku eða mánuði. Daglega.
/api/v1/market/cheapest451 · leyfi Svæðin með lægsta meðalverð dagsins. Daglega.
/api/v1/market/expensive451 · leyfi Svæðin með hæsta meðalverð dagsins. Daglega.
/api/v1/market/spreads451 · leyfi Munurinn á ódýrustu og dýrustu klukkustundinni, eftir svæðum. Daglega.
/api/v1/market/cheapest-window451 · leyfi Ódýrasti samfelldi N klukkustunda glugginn á svæði. Daglega.
/api/v1/market/weekly451 · leyfi Vikuskýrslan, þegar vikunni er lokið. Vikulega.

Hvers vegna verðleiðirnar svara með 451

Markaðsgögnin koma frá gagnsæisvettvangi ENTSO-E. Við söfnum þeim og sýnum þau á vefnum með heimildina við hlið hverrar tölu, en að dreifa þeim áfram um API er ekki það sama og að birta þau, og skilmálar um endurnotkun hafa ekki enn verið staðfestir og skráðir af okkur.

Þangað til skila verðleiðirnar 451 — kóðanum fyrir „ekki tiltækt af lagalegum ástæðum“ — í stað þess að afhenda hljóðlega eitthvað sem við höfum ekki rétt til að afhenda. Leyfiskerfið virkar eftir gagnalindum, ekki eftir löndum, svo að ekki þarf að breyta kóða til að opna leiðirnar.

Reglur um góða hegðun

Engin takmörk eru á fjölda fyrirspurna, og við vildum helst ekki þurfa að setja þau. Svörin bera cache-control: virtu það og þú færð nákvæmlega sömu tölur án þess að spyrja tvisvar. Rauntímagögn breytast ekki oftar en rekstraraðili þeirra birtir — ein fyrirspurn á sekúndu fyrir land sem birtir á klukkustundar fresti skilar engu nýju.

Ef þú notar gögnin opinberlega skaltu vísa í upprunalegu heimildina (flutningsfyrirtækið eða ENTSO-E), ekki í nafn okkar: við flytjum gögnin, við framleiðum þau ekki.

Sjá einnig: Gagnalindir · Aðferðafræði · Staða kerfisins · llms.txt