Η υποβολή ειδήσεων και ο στόλος NakBus βρίσκονται πλέον στον πίνακα συνεργατών
Συνδέστε τον λογαριασμό προγραμματιστή σας με έναν λογαριασμό Nakordoni Partners με το ίδιο email και διαχειριστείτε εκεί τις ειδήσεις και τον στόλο λεωφορείων σας (NakDriver / NakManager), με ρόλους ομάδας. Τα κλειδιά API, τα endpoints και οι εφαρμογές σας παραμένουν αμετάβλητα, και οι σελίδες εδώ συνεχίζουν να λειτουργούν. Άνοιγμα Nakordoni Partners

← Όλα τα endpoints

API Τιμές Καυσίμων ανά Πόλη Online

Τιμές καυσίμων ανά πόλη: φθηνότερο πρατήριο και μέσος όρος 5 φθηνότερων.

GET https://nakordoni.eu/api/v1/data/fuel-cities — κλάση ποσόστωσης: cheap

ΠαράμετροςΠεριγραφή
countryΚωδικός χώρας ISO-2 (υποχρεωτικός). Δεκτοί: at, de, fr, es, it, pt, si, lu, ro, dk, hr — το ro επί του παρόντος απαντά χωρίς πόλεις (δεν έχουν καταγραφεί πρατήρια με τιμές)
fuel_typediesel (προεπιλογή) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — η διαθεσιμότητα καθορίζεται ανά χώρα, όχι ανά πλατφόρμα. Διαβάστε το `available_fuel_types` στην απόκριση και επιλέξτε από εκεί· ένας τύπος που απουσιάζει από τη λίστα επιστρέφει κενό πίνακα `cities` με ένα `note`, όχι εφεδρικό τύπο. Γίνονται δεκτές και οι τοπικές ονομασίες αντλίας — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — και αντιστοιχίζονται με βάση το `country` (ή, για τα προϊόντα συντεταγμένων, τη χώρα στην οποία εμπίπτει το σημείο), επειδή η ίδια διατύπωση δεν σημαίνει παντού τον ίδιο τύπο: το «95» είναι E10 σε δανική, φινλανδική, γαλλική, βρετανική, βελγική ή ολλανδική αντλία και E5 σε πολωνική ή γερμανική. Η απόκριση επιστρέφει τα `fuel_type` (κανονικό), `fuel_type_requested` (όπως το πληκτρολογήσατε) και `fuel_type_local`. Μια ονομασία που δεν μπορούμε να εντοπίσουμε δεν αντικαθίσταται ποτέ από προεπιλεγμένο τύπο· η απόκριση επιστρέφει κενή και το δηλώνει. Πλήρης πίνακας ονομασιών ανά χώρα: /api/v2/data/fuel-grades.
langΚωδικός γλώσσας για τα ονόματα πόλεων (προεπιλογή en)

Πεδία της απάντησης — μέσα στο αντικείμενο data του φακέλου απάντησης. Το [] δηλώνει λίστα, άρα το data.items[].name είναι το πεδίο name κάθε στοιχείου. Ένα πεδίο είναι null, απουσιάζει ή είναι κενή λίστα όταν δεν έχουμε τιμή — ποτέ κάτι εικονικό.

ΠεδίοΠεριγραφή
data.countryISO-2 country, with country_name in the requested language.
data.fuel_typeThe canonical grade the prices are for. fuel_type_requested is what you sent, fuel_type_local the name a driver there uses.
data.available_fuel_typesGrades this country actually has priced stations for — derived from the data, not a menu. Pick fuel_type from it.
data.available_fuel_types_localThe same list keyed by grade, valued with the local pump name.
data.cities[].city_nameCity, with city_key, lat and lng.
data.cities[].cheapestLowest station price in that city, with avg_price across the top stations, both in data.currency.
data.cities[].stations[]The stations behind those numbers: name, brand, price, lat, lng.
data.countCities returned. An empty cities list with a note means the country has no price for that grade — it is never answered with a different grade.
curl "https://nakordoni.eu/api/v1/data/fuel-cities?country=hr&fuel_type=diesel&lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Συνδεθείτε ως προγραμματιστής για να δοκιμάσετε ζωντανά αυτό το endpoint στο Sandbox — 50 δωρεάν δοκιμαστικές κλήσεις την ημέρα. Σύνδεση

Ενημερώθηκε