API ονομάτων καυσίμων Online
Ο πίνακας ονομασιών πίσω από κάθε προϊόν καυσίμου: το κανονικό μας λεξιλόγιο ποιοτήτων (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) και πώς ονομάζεται κάθε ποιότητα σε μια αντλία σε 41 ευρωπαϊκές χώρες — ON και Olej napędowy στην Πολωνία, Nafta στην Τσεχία, Gázolaj στην Ουγγαρία, Motorină στη Ρουμανία και τη Μολδαβία, ДП στην Ουκρανία, Motorin στην Τουρκία, Gasóleo στην Πορτογαλία και την Ισπανία. Κάθε όνομα που αναφέρεται εδώ γίνεται δεκτό από την παράμετρο fuel_type των προϊόντων fuel, fuel-local, fuel-stations, fuel-cheapest και fuel-cities, οπότε μπορείτε να περάσετε απευθείας τη δική του διατύπωση του οδηγού. Η επίλυση γίνεται πρώτα ανά χώρα επειδή η ίδια λέξη δεν είναι η ίδια ποιότητα παντού: το “95” είναι E10 σε μια δανική, φινλανδική, γαλλική, βρετανική, βελγική ή ολλανδική αντλία και E5 σε μια πολωνική ή γερμανική — στείλτε `country` μαζί με ένα τοπικό όνομα. Αυτός είναι ένας πίνακας ΟΝΟΜΑΣΙΑΣ και είναι σκόπιμα ευρύτερος από την κάλυψη τιμών μας: απαντά πώς ονομάζεται μια ποιότητα σε μια χώρα είτε τιμολογούμε εκεί είτε όχι (δεν έχουμε καθόλου τιμές πρατηρίων για TR ή MD), και το `station_level` σε κάθε ποιότητα δείχνει μόνο ποιες ποιότητες αναφέρουν οι ροές δεδομένων πρατηρίων οπουδήποτε. Περάστε `fuel_type` για να δοκιμάσετε ένα όνομα και να λάβετε πίσω την κανονική ποιότητα στην οποία επιλύεται, ή null όταν δεν μπορούμε να το εντοπίσουμε — δεν μαντεύουμε ποτέ μια προεπιλεγμένη ποιότητα. Κάθε ποιότητα φέρει επίσης priced_countries και priced_station_counts, μετρημένα από τον ζωντανό δείκτη πρατηρίων και όχι προκαθορισμένα, ώστε να μπορείτε να διακρίνετε ένα όνομα που ΑΠΟΔΕΧΟΜΑΣΤΕ για μια χώρα (ο πίνακας `countries`) από μια ποιότητα για την οποία πράγματι ΤΙΜΟΛΟΓΟΥΜΕ εκεί· με ?country= κάθε ποιότητα φέρει επιπλέον priced_here, και το 0 είναι μια πραγματική απάντηση που σημαίνει ότι η λέξη της αντλίας υπάρχει τοπικά, αλλά καμία ροή δεν την τιμολογεί.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— κλάση ποσόστωσης: cheap
| Παράμετρος | Περιγραφή |
|---|---|
country | Προαιρετικό φίλτρο ISO-2 — επιστρέφει μόνο τις τοπικές ονομασίες αυτής της χώρας αντί και των 41 (PL, DE, UA, TR, MD, …). 404 αν η χώρα δεν υπάρχει στον πίνακα. |
fuel_type | Προαιρετικός έλεγχος: αναλύει μία ονομασία στο πλαίσιο του `country` και αναφέρει τον κανονικό τύπο στο `resolved` (π.χ. country=PL&fuel_type=ON → diesel· country=DK&fuel_type=95 → e10· country=PL&fuel_type=95 → e5). Το null σημαίνει ότι δεν μπορέσαμε να την εντοπίσουμε. |
Πεδία της απάντησης — μέσα στο αντικείμενο data του φακέλου απάντησης. Το [] δηλώνει λίστα, άρα το data.items[].name είναι το πεδίο name κάθε στοιχείου. Ένα πεδίο είναι null, απουσιάζει ή είναι κενή λίστα όταν δεν έχουμε τιμή — ποτέ κάτι εικονικό.
| Πεδίο | Περιγραφή |
|---|---|
data.grades[].code | Canonical grade code — the value fuel_type takes in every fuel product. |
data.grades[].label | Plain-English description of the grade. |
data.grades[].family | diesel | petrol | gas | other. |
data.grades[].station_level | true when station feeds report this grade anywhere; false means it only ever appears in national averages. |
data.countries | Keyed by ISO-2 country, then by grade code, valued with that country's names for it. The first name in each list is the one to show a driver. |
data.count | How many countries the answer covers (41 unfiltered, 1 with ?country=). |
data.resolved | Only with ?fuel_type=: requested, country, grade (null when we cannot place the name), label and local_name. |
data.note | How resolution works, in one paragraph — safe to show to your users. |
curl "https://nakordoni.eu/api/v2/data/fuel-grades?country=PL&fuel_type=ON" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Ενημερώθηκε