Datele, direct din platformă
Același strat pe care îl citesc paginile site-ului. Fără cheie, fără înregistrare, JSON peste HTTP. Fiecare răspuns spune din ce sursă vine, la ce moment se referă și cât de proaspăt e.
Sistemul electric, în timp real
Consum, producție pe surse și schimburi la graniță, așa cum le publică operatorii de transport. Deschise.
| Adresă | Ce întoarce | Cadență |
|---|---|---|
/api/v1/countries |
Toate țările de pe platformă, cu zonele lor și starea acoperirii. | Se schimbă rar — la modificări de registru. |
/api/v1/countries/:iso2/latest |
Instantaneul unei țări: consum, producție pe surse, sold la graniță. | Cât de des publică operatorul ei — de la 10 secunde la o oră. |
/api/v1/countries/:iso2/history |
Serie de timp pentru o țară, pe un interval ales. | Aceeași cadență ca instantaneul. |
/api/v1/europe/latest |
Totalul european și fiecare țară care intră în el. | Un minut. |
/api/v1/status |
Starea colectării: ce sursă a publicat ultima oară și când. | Continuu. |
/api/v1/licenses |
Ce are voie să facă platforma cu datele fiecărei surse. | La schimbarea termenilor unei surse. |
/api/v1/search |
Căutare în țări, zone și termeni. | Continuu. |
Piața zi-înainte
Prețurile licitate pentru ziua următoare, pe zone de ofertare. Închise deocamdată — vezi mai jos de ce.
| Adresă | Ce întoarce | Cadență |
|---|---|---|
/api/v1/prices/latest451 · licență |
Ultimul preț cunoscut pe fiecare zonă. | O dată pe zi, după licitație. |
/api/v1/prices/zones451 · licență |
Zonele de ofertare, cu fusul și moneda fiecăreia. | Se schimbă rar. |
/api/v1/prices/date451 · licență |
Toate zonele, pentru o zi de livrare aleasă. | Zilnic. |
/api/v1/prices/country/:iso2451 · licență |
Prețurile unei țări, pe fiecare zonă a ei. | Zilnic. |
/api/v1/prices/:zone/history451 · licență |
Istoricul unei zone, interval cu interval. | Zilnic. |
/api/v1/prices/:zone/summary451 · licență |
Medie, minim, maxim și cuantile pe zi, săptămână sau lună. | Zilnic. |
/api/v1/market/cheapest451 · licență |
Zonele cu cel mai mic preț mediu al zilei. | Zilnic. |
/api/v1/market/expensive451 · licență |
Zonele cu cel mai mare preț mediu al zilei. | Zilnic. |
/api/v1/market/spreads451 · licență |
Diferența dintre cea mai ieftină și cea mai scumpă oră, pe zonă. | Zilnic. |
/api/v1/market/cheapest-window451 · licență |
Cea mai ieftină fereastră continuă de N ore dintr-o zonă. | Zilnic. |
/api/v1/market/weekly451 · licență |
Raportul săptămânal, o dată încheiată săptămâna. | Săptămânal. |
De ce prețurile răspund cu 451
Datele de piață vin de pe platforma de transparență ENTSO-E. Le colectăm și le arătăm pe site cu sursa scrisă lângă fiecare cifră, dar redistribuirea lor prin API e altceva decât afișarea, iar termenii de reutilizare nu sunt încă verificați și înregistrați de noi.
Până atunci, rutele de preț întorc 451 —
codul pentru „indisponibil din motive legale" — în loc să livreze tăcut ceva
ce n-avem dreptul să livrăm. Sistemul de licențiere e pe sursă, nu pe țară,
deci deschiderea lor nu cere nicio schimbare de cod.
Reguli de bună purtare
Nu există limită de cereri, și ne-ar plăcea să nu
fie nevoie de una. Răspunsurile poartă cache-control: respectă-l
și vei lua exact aceleași cifre fără să ceri de două ori. Datele în timp real
nu se schimbă mai des decât publică operatorul lor — o cerere pe secundă
pentru o țară care publică din oră în oră nu aduce nimic nou.
Dacă folosești datele public, scrie sursa originală (operatorul de transport sau ENTSO-E), nu numele nostru: noi le transportăm, nu le producem.
Vezi și: sursele de date · metodologia · starea sistemului · llms.txt