API ονομάτων καυσίμων Online
Ο πίνακας ονομάτων πάνω στον οποίο στηρίζονται όλα τα προϊόντα καυσίμων: οι κανονικοί μας κωδικοί καυσίμων και το πώς λέγεται κάθε καύσιμο στην αντλία σε 41 ευρωπαϊκές χώρες — ON στην Πολωνία, Nafta στην Τσεχία, Gázolaj στην Ουγγαρία, Motorină στη Ρουμανία, ДП στην Ουκρανία, Motorin στην Τουρκία. Κάθε όνομα του πίνακα το δέχεται η παράμετρος fuel_type των υπόλοιπων προϊόντων καυσίμων και ερμηνεύεται πρώτα με βάση τη χώρα: το «95» είναι E10 σε δανέζικη αντλία και E5 σε πολωνική.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— κλάση ποσόστωσης: cheap
| Παράμετρος | Περιγραφή |
|---|---|
country | Optional ISO-2 filter — return just that country's local names instead of all 41 (PL, DE, UA, TR, MD, …). 404 when the country is not in the table. |
fuel_type | Optional probe: resolve one name in the context of `country` and report the canonical grade under `resolved` (e.g. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null means we could not place it. |
Πεδία της απάντησης — μέσα στο αντικείμενο 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"