API

Τα δεδομένα, απευθείας από την πλατφόρμα

Το ίδιο επίπεδο που διαβάζουν οι σελίδες του ιστότοπου. Χωρίς κλειδί, χωρίς εγγραφή, JSON μέσω HTTP. Κάθε απόκριση αναφέρει από ποια πηγή προέρχεται, σε ποια στιγμή αναφέρεται και πόσο πρόσφατη είναι.

Το ηλεκτρικό σύστημα, σε πραγματικό χρόνο

Ζήτηση, παραγωγή ανά πηγή και διασυνοριακές ανταλλαγές, όπως τις δημοσιεύουν οι διαχειριστές συστημάτων μεταφοράς. Ελεύθερη πρόσβαση.

Διεύθυνση Τι επιστρέφει Συχνότητα
/api/v1/countries Όλες οι χώρες της πλατφόρμας, με τις ζώνες τους και την κατάσταση κάλυψης. Αλλάζει σπάνια — όταν αλλάζει το μητρώο.
/api/v1/countries/:iso2/latest Στιγμιότυπο μιας χώρας: ζήτηση, παραγωγή ανά πηγή, ισοζύγιο στα σύνορα. Όσο συχνά δημοσιεύει ο διαχειριστής της — από 10 δευτερόλεπτα έως μία ώρα.
/api/v1/countries/:iso2/history Χρονοσειρά για μία χώρα, σε επιλεγμένο διάστημα. Ίδια συχνότητα με το στιγμιότυπο.
/api/v1/europe/latest Το ευρωπαϊκό σύνολο και κάθε χώρα που περιλαμβάνεται σε αυτό. Ένα λεπτό.
/api/v1/status Η κατάσταση της συλλογής: ποια πηγή δημοσίευσε τελευταία και πότε. Συνεχής.
/api/v1/licenses Τι επιτρέπεται να κάνει η πλατφόρμα με τα δεδομένα κάθε πηγής. Όταν αλλάζουν οι όροι μιας πηγής.
/api/v1/search Αναζήτηση σε χώρες, ζώνες και όρους. Συνεχής.

Η αγορά επόμενης ημέρας

Οι τιμές της δημοπρασίας για την επόμενη ημέρα, ανά ζώνη προσφορών. Πρόσβαση κλειστή προς το παρόν — δείτε παρακάτω γιατί.

Διεύθυνση Τι επιστρέφει Συχνότητα
/api/v1/prices/latest451 · άδεια χρήσης Η τελευταία γνωστή τιμή για κάθε ζώνη. Μία φορά την ημέρα, μετά τη δημοπρασία.
/api/v1/prices/zones451 · άδεια χρήσης Οι ζώνες προσφορών, με τη ζώνη ώρας και το νόμισμα καθεμιάς. Αλλάζει σπάνια.
/api/v1/prices/date451 · άδεια χρήσης Όλες οι ζώνες, για επιλεγμένη ημέρα παράδοσης. Ημερήσια.
/api/v1/prices/country/:iso2451 · άδεια χρήσης Οι τιμές μιας χώρας, για καθεμία από τις ζώνες της. Ημερήσια.
/api/v1/prices/:zone/history451 · άδεια χρήσης Το ιστορικό μιας ζώνης, διάστημα προς διάστημα. Ημερήσια.
/api/v1/prices/:zone/summary451 · άδεια χρήσης Μέση, ελάχιστη, μέγιστη τιμή και ποσοστημόρια ανά ημέρα, εβδομάδα ή μήνα. Ημερήσια.
/api/v1/market/cheapest451 · άδεια χρήσης Οι ζώνες με τη χαμηλότερη μέση τιμή της ημέρας. Ημερήσια.
/api/v1/market/expensive451 · άδεια χρήσης Οι ζώνες με την υψηλότερη μέση τιμή της ημέρας. Ημερήσια.
/api/v1/market/spreads451 · άδεια χρήσης Η διαφορά μεταξύ της φθηνότερης και της ακριβότερης ώρας, ανά ζώνη. Ημερήσια.
/api/v1/market/cheapest-window451 · άδεια χρήσης Το φθηνότερο συνεχές παράθυρο N ωρών σε μια ζώνη. Ημερήσια.
/api/v1/market/weekly451 · άδεια χρήσης Η εβδομαδιαία έκθεση, μόλις κλείσει η εβδομάδα. Εβδομαδιαία.

Γιατί οι διαδρομές τιμών απαντούν με 451

Τα δεδομένα της αγοράς προέρχονται από την πλατφόρμα διαφάνειας του ENTSO-E. Τα συλλέγουμε και τα εμφανίζουμε στον ιστότοπο με την πηγή γραμμένη δίπλα σε κάθε αριθμό, αλλά η αναδιανομή τους μέσω API δεν είναι το ίδιο με την εμφάνισή τους, και οι όροι επαναχρησιμοποίησης δεν έχουν ακόμη επαληθευτεί και καταχωριστεί από εμάς.

Μέχρι τότε, οι διαδρομές τιμών επιστρέφουν 451 — τον κωδικό για «μη διαθέσιμο για νομικούς λόγους» — αντί να παραδίδουν αθόρυβα κάτι που δεν έχουμε δικαίωμα να παραδώσουμε. Το σύστημα αδειών λειτουργεί ανά πηγή, όχι ανά χώρα, οπότε το άνοιγμά τους δεν απαιτεί καμία αλλαγή κώδικα.

Κανόνες καλής συμπεριφοράς

Δεν υπάρχει όριο αιτημάτων, και θα θέλαμε να μη χρειαστεί να υπάρξει. Οι αποκρίσεις φέρουν cache-control: τηρήστε το και θα λάβετε ακριβώς τους ίδιους αριθμούς χωρίς να ρωτήσετε δύο φορές. Τα δεδομένα πραγματικού χρόνου δεν αλλάζουν συχνότερα από όσο δημοσιεύει ο διαχειριστής τους — ένα αίτημα ανά δευτερόλεπτο για μια χώρα που δημοσιεύει ανά ώρα δεν φέρνει τίποτα νέο.

Αν χρησιμοποιείτε τα δεδομένα δημόσια, αναφέρετε την αρχική πηγή (τον διαχειριστή συστήματος μεταφοράς ή το ENTSO-E), όχι το δικό μας όνομα: εμείς τα μεταφέρουμε, δεν τα παράγουμε.

Δείτε επίσης: Πηγές δεδομένων · Μεθοδολογία · Κατάσταση συστήματος · llms.txt