Tiedot suoraan palvelusta
Sama kerros, jota sivuston omat sivut lukevat. Ei avainta, ei rekisteröitymistä, JSON HTTP:n kautta. Jokainen vastaus kertoo, mistä lähteestä se tuli, mihin hetkeen se viittaa ja kuinka tuore se on.
Sähköjärjestelmä reaaliajassa
Kulutus, tuotanto energialähteittäin ja rajasiirrot sellaisina kuin kantaverkkoyhtiöt ne julkaisevat. Avoin.
| Osoite | Mitä se palauttaa | Tahti |
|---|---|---|
/api/v1/countries |
Kaikki palvelun maat tarjousalueineen ja kattavuuden tiloineen. | Muuttuu harvoin — kun rekisteri muuttuu. |
/api/v1/countries/:iso2/latest |
Maan tilannekuva: kulutus, tuotanto energialähteittäin, rajasiirtojen tase. | Niin usein kuin maan verkonhaltija julkaisee — 10 sekunnista tuntiin. |
/api/v1/countries/:iso2/history |
Yhden maan aikasarja valitulta ajanjaksolta. | Sama tahti kuin tilannekuvalla. |
/api/v1/europe/latest |
Euroopan kokonaissumma ja jokainen siihen sisältyvä maa. | Yksi minuutti. |
/api/v1/status |
Tiedonkeruun tila: mikä lähde julkaisi viimeksi ja milloin. | Jatkuva. |
/api/v1/licenses |
Mitä palvelu saa tehdä kunkin lähteen tiedoilla. | Kun lähteen ehdot muuttuvat. |
/api/v1/search |
Haku maista, tarjousalueista ja termeistä. | Jatkuva. |
Vuorokausimarkkina
Seuraavalle päivälle huutokaupatut hinnat tarjousalueittain. Toistaiseksi suljettu — syy kerrotaan alla.
| Osoite | Mitä se palauttaa | Tahti |
|---|---|---|
/api/v1/prices/latest451 · lisenssi |
Viimeisin tunnettu hinta kullekin alueelle. | Kerran päivässä huutokaupan jälkeen. |
/api/v1/prices/zones451 · lisenssi |
Tarjousalueet sekä kunkin aikavyöhyke ja valuutta. | Muuttuu harvoin. |
/api/v1/prices/date451 · lisenssi |
Kaikki alueet valitulle toimituspäivälle. | Päivittäin. |
/api/v1/prices/country/:iso2451 · lisenssi |
Maan hinnat sen jokaiselle alueelle. | Päivittäin. |
/api/v1/prices/:zone/history451 · lisenssi |
Alueen historia jakso jaksolta. | Päivittäin. |
/api/v1/prices/:zone/summary451 · lisenssi |
Keskiarvo, minimi, maksimi ja kvantiilit päivittäin, viikoittain tai kuukausittain. | Päivittäin. |
/api/v1/market/cheapest451 · lisenssi |
Alueet, joilla päivän keskihinta on alhaisin. | Päivittäin. |
/api/v1/market/expensive451 · lisenssi |
Alueet, joilla päivän keskihinta on korkein. | Päivittäin. |
/api/v1/market/spreads451 · lisenssi |
Halvimman ja kalleimman tunnin erotus alueittain. | Päivittäin. |
/api/v1/market/cheapest-window451 · lisenssi |
Alueen halvin yhtenäinen N tunnin aikaikkuna. | Päivittäin. |
/api/v1/market/weekly451 · lisenssi |
Viikkoraportti, kun viikko on päättynyt. | Viikoittain. |
Miksi hintareitit vastaavat koodilla 451
Markkinatiedot tulevat ENTSO-E:n avoimuusalustalta. Keräämme ne ja näytämme ne sivustolla lähde jokaisen luvun vieressä, mutta niiden edelleenjakelu rajapinnan kautta ei ole sama asia kuin niiden näyttäminen, emmekä ole vielä tarkistaneet ja kirjanneet uudelleenkäytön ehtoja.
Siihen asti hintareitit palauttavat koodin 451 — koodin, joka tarkoittaa ”ei saatavilla oikeudellisista syistä” — sen sijaan, että ne hiljaa toimittaisivat jotain, mihin meillä ei ole oikeutta. Lisensointi toimii lähteittäin, ei maittain, joten reittien avaaminen ei vaadi koodimuutoksia.
Hyvän käytöksen säännöt
Pyyntörajaa ei ole, ja toivomme, ettei sellaista tarvita. Vastauksissa on cache-control-otsake: noudata sitä, niin saat täsmälleen samat luvut kysymättä kahdesti. Reaaliaikaiset tiedot eivät muutu useammin kuin verkonhaltija ne julkaisee — pyyntö sekunnissa maalle, joka julkaisee tunneittain, ei tuo mitään uutta.
Jos käytät tietoja julkisesti, mainitse alkuperäinen lähde (kantaverkkoyhtiö tai ENTSO-E), älä meitä: me kuljetamme tiedot, emme tuota niitä.
Katso myös: Tietolähteet · Menetelmät · Järjestelmän tila · llms.txt