API Prezzi carburante per città Online
Prezzi carburante per città: la stazione più economica e la media delle 5 più economiche.
GET https://nakordoni.eu/api/v1/data/fuel-cities
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
country | Codice paese ISO-2 (obbligatorio). Accettati: at, de, fr, es, it, pt, si, lu, ro, dk, hr — ro attualmente risponde senza città (nessun distributore con prezzi registrato) |
fuel_type | diesel (predefinito) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — la disponibilità è per paese, non per piattaforma. Leggete `available_fuel_types` nella risposta e sceglietevi da lì; un tipo assente da quell'elenco restituisce un array `cities` vuoto con un `note`, non un tipo di ripiego. Sono accettate anche le denominazioni locali alla pompa — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — vengono risolte rispetto a `country` (o, per i prodotti basati su coordinate, rispetto al paese in cui ricade il punto), perché la stessa dicitura non indica ovunque lo stesso tipo: «95» è E10 su una pompa danese, finlandese, francese, britannica, belga o olandese ed E5 su una polacca o tedesca. La risposta restituisce `fuel_type` (canonico), `fuel_type_requested` (così come lo avete scritto) e `fuel_type_local`. Una denominazione che non riusciamo a collocare non viene mai sostituita con un tipo predefinito: la risposta torna vuota e lo dichiara. Tabella completa delle denominazioni per paese: /api/v2/data/fuel-grades. |
lang | Codice lingua per i nomi delle città (predefinito en) |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
data.country | ISO-2 country, with country_name in the requested language. |
data.fuel_type | The 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_types | Grades this country actually has priced stations for — derived from the data, not a menu. Pick fuel_type from it. |
data.available_fuel_types_local | The same list keyed by grade, valued with the local pump name. |
data.cities[].city_name | City, with city_key, lat and lng. |
data.cities[].cheapest | Lowest 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.count | Cities 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"
🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 50 chiamate di prova gratuite al giorno. Accedi