/
Επισκόπηση του API: όνομα, έκδοση, λίστα endpoints και κάλυψη του dataset (ημερομηνίες, σύνολο εγγραφών).
Παράδειγμα
curl https://nireas.iee.ihu.gr/fuel/api/v1/
Επισκόπηση
Το API είναι read-only και δημόσιο — δεν χρειάζεται API key ή authentication. Όλα τα δεδομένα προέρχονται από τα ημερήσια δελτία τιμών του Υπουργείου Ενέργειας.
- Διαθέσιμα μόνο GET requests
- Όλες οι απαντήσεις είναι σε JSON (UTF-8)
- Οι τιμές δίνονται σε EUR/L
- CORS ενεργό για όλες τις προελεύσεις
Βασικό URL
https://nireas.iee.ihu.gr/fuel/api/v1/
Όλες οι διαδρομές είναι σχετικές με αυτό το prefix. Η έκδοση (v1) είναι μέρος του URL ώστε μελλοντικές αλλαγές να μην σπάσουν υπάρχοντα clients.
Δομή Απάντησης
Κάθε επιτυχημένη απάντηση έχει την ίδια μορφή:
{
"data": // τα δεδομένα του endpoint (object ή array),
"meta": // πληροφορίες σχετικά με την απάντηση
}
Σε περίπτωση σφάλματος:
{
"error": {
"code": "invalid_param",
"message": "Human-readable description",
"details": { ... }
},
"meta": { ... }
}
Endpoints
/prefectures
Επιστρέφει τους 51 νομούς της Ελλάδας συν την εθνική σταθμισμένη μέση τιμή. Χρησιμοποιήστε το id ως παράμετρο στο /prices.
Παράδειγμα απάντησης
{
"data": [
{ "id": 1, "name": "ΠΑΝΕΛΛΗΝΙΟΣ ΣΤΑΘΜΙΣΜΕΝΟΣ Μ.Ο." },
{ "id": 2, "name": "ΑΘΗΝΩΝ" },
{ "id": 3, "name": "ΘΕΣΣΑΛΟΝΙΚΗΣ" }
],
"meta": { "count": 52 }
}
/fuel-types
Επιστρέφει τους τύπους καυσίμων που παρακολουθούνται.
Παράδειγμα απάντησης
{
"data": [
{ "id": 1, "name": "Αμόλυβδη 95" },
{ "id": 2, "name": "Αμόλυβδη 100" },
{ "id": 3, "name": "Diesel Κίνησης" },
{ "id": 4, "name": "Diesel Θέρμανσης" },
{ "id": 5, "name": "Υγραέριο Κίνησης (Auto Gas)" }
],
"meta": { "count": 5 }
}
/prices
Χρονοσειρά τιμών για συγκεκριμένο νομό + καύσιμο σε ένα διάστημα ημερομηνιών. Τα σημεία επιστρέφονται ταξινομημένα από το παλαιότερο προς το νεότερο.
Παράμετροι
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
prefecture_id | integer | ID από το /prefectures |
fuel_type_id | integer | ID από το /fuel-types |
from | YYYY-MM-DD | Αρχή διαστήματος (συμπεριλαμβανομένης) |
to | YYYY-MM-DD | Τέλος διαστήματος (συμπεριλαμβανομένης) |
Όλες οι παράμετροι είναι υποχρεωτικές.
Παράδειγμα
curl 'https://nireas.iee.ihu.gr/fuel/api/v1/prices?prefecture_id=1&fuel_type_id=1&from=2026-01-01&to=2026-04-22'
Παράδειγμα απάντησης
{
"data": [
{ "date": "2026-01-02", "price": 1.823 },
{ "date": "2026-01-03", "price": 1.819 },
{ "date": "2026-01-04", "price": 1.821 }
],
"meta": {
"count": 3,
"unit": "EUR/L",
"prefecture": { "id": 1, "name": "ΠΑΝΕΛΛΗΝΙΟΣ ΣΤΑΘΜΙΣΜΕΝΟΣ Μ.Ο." },
"fuel_type": { "id": 1, "name": "Αμόλυβδη 95" },
"from": "2026-01-01",
"to": "2026-04-22"
}
}
/prices/latest
Snapshot του πιο πρόσφατου δελτίου: όλες οι τιμές, για κάθε νομό και κάθε καύσιμο, για την τελευταία διαθέσιμη ημερομηνία.
Παράδειγμα
curl https://nireas.iee.ihu.gr/fuel/api/v1/prices/latest
Σφάλματα
Σε περίπτωση σφάλματος, το API επιστρέφει το αντίστοιχο HTTP status και ένα error object με κωδικό και μήνυμα.
| Status | Code | Πότε συμβαίνει |
|---|---|---|
| 400 | missing_param | Λείπει υποχρεωτική παράμετρος |
| 400 | invalid_param | Παράμετρος με λάθος τύπο ή μορφή |
| 400 | invalid_range | from μετά το to |
| 404 | not_found | Endpoint, νομός ή καύσιμο δεν υπάρχει |
| 404 | unsupported_version | Λείπει ή είναι άγνωστη η έκδοση API στο URL |
| 405 | method_not_allowed | Στάλθηκε non-GET request |
| 500 | internal_error | Απρόσμενο σφάλμα στον server |