API

Andmed otse platvormilt

Sama kiht, mida loevad saidi enda lehed. Ilma võtme ja registreerimiseta, JSON üle HTTP. Iga vastus ütleb, millisest allikast see pärineb, millise hetke kohta see käib ja kui värske see on.

Elektrisüsteem reaalajas

Tarbimine, tootmine allikate kaupa ja piiriülene vahetus, nagu põhivõrguettevõtjad neid avaldavad. Avatud.

Aadress Mida tagastab Sagedus
/api/v1/countries Kõik platvormi riigid koos nende piirkondade ja kaetuse olekuga. Muutub harva — kui register muutub.
/api/v1/countries/:iso2/latest Riigi hetkeseis: tarbimine, tootmine allikate kaupa, piirisaldo. Nii sageli, kui riigi operaator avaldab — 10 sekundist tunnini.
/api/v1/countries/:iso2/history Ühe riigi aegrida valitud ajavahemikus. Sama sagedus nagu hetkeseisul.
/api/v1/europe/latest Euroopa kogusumma ja kõik sellesse arvatud riigid. Üks minut.
/api/v1/status Andmekogumise olek: milline allikas avaldas viimati ja millal. Pidev.
/api/v1/licenses Mida platvorm tohib iga allika andmetega teha. Kui allika tingimused muutuvad.
/api/v1/search Otsing riikide, piirkondade ja terminite hulgast. Pidev.

Päev-ette turg

Järgmise päeva oksjonihinnad hinnapiirkondade kaupa. Praegu suletud — vaata allpool, miks.

Aadress Mida tagastab Sagedus
/api/v1/prices/latest451 · litsents Iga piirkonna viimane teadaolev hind. Kord päevas, pärast oksjonit.
/api/v1/prices/zones451 · litsents Hinnapiirkonnad koos igaühe ajavööndi ja valuutaga. Muutub harva.
/api/v1/prices/date451 · litsents Kõik piirkonnad valitud tarnepäeva kohta. Iga päev.
/api/v1/prices/country/:iso2451 · litsents Riigi hinnad iga tema piirkonna kohta. Iga päev.
/api/v1/prices/:zone/history451 · litsents Piirkonna ajalugu intervallide kaupa. Iga päev.
/api/v1/prices/:zone/summary451 · litsents Keskmine, miinimum, maksimum ja kvantiilid päevade, nädalate või kuude kaupa. Iga päev.
/api/v1/market/cheapest451 · litsents Päeva madalaima keskmise hinnaga piirkonnad. Iga päev.
/api/v1/market/expensive451 · litsents Päeva kõrgeima keskmise hinnaga piirkonnad. Iga päev.
/api/v1/market/spreads451 · litsents Odavaima ja kalleima tunni vahe piirkondade kaupa. Iga päev.
/api/v1/market/cheapest-window451 · litsents Piirkonna odavaim katkematu N-tunnine ajaaken. Iga päev.
/api/v1/market/weekly451 · litsents Nädalaaruanne pärast nädala lõppu. Kord nädalas.

Miks hinnamarsruudid vastavad koodiga 451

Turuandmed pärinevad ENTSO-E läbipaistvusplatvormilt. Me kogume neid ja näitame saidil, allikas kirjas iga arvu kõrval, kuid nende edasilevitamine API kaudu ei ole sama mis kuvamine ja taaskasutustingimusi pole me veel kontrollinud ega registreerinud.

Seni tagastavad hinnamarsruudid koodi 451 — „pole õiguslikel põhjustel saadaval“ — selle asemel, et vaikselt edastada midagi, mida meil pole õigust edastada. Litsentsisüsteem töötab allikate, mitte riikide kaupa, seega ei nõua nende avamine koodi muutmist.

Hea käitumise reeglid

Päringute arvul pole piirangut ja me soovime, et seda poleks vaja kehtestada. Vastustel on päis cache-control: arvesta sellega ja saad täpselt samad arvud ilma kaks korda küsimata. Reaalajas andmed ei muutu sagedamini, kui nende operaator avaldab — üks päring sekundis riigi kohta, mis avaldab andmeid kord tunnis, ei too midagi uut.

Kui kasutad andmeid avalikult, viita algallikale (põhivõrguettevõtjale või ENTSO-E-le), mitte meie nimele: me edastame andmeid, me ei tooda neid.

Vaata ka: Andmeallikad · Metoodika · Süsteemi olek · llms.txt