API dei nomi dei carburanti Online
La tabella dei nomi dietro ogni prodotto carburante: il nostro vocabolario canonico dei gradi (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) e come viene chiamato ogni grado alla pompa in 41 paesi europei — ON e Olej napędowy in Polonia, Nafta in Cechia, Gázolaj in Ungheria, Motorină in Romania e Moldova, ДП in Ucraina, Motorin in Turchia, Gasóleo in Portogallo e Spagna. Ogni nome qui elencato è accettato dal parametro fuel_type dei prodotti fuel, fuel-local, fuel-stations, fuel-cheapest e fuel-cities, così potete passare direttamente la dicitura usata da un automobilista. La risoluzione avviene prima per paese perché la stessa parola non è lo stesso grado ovunque: “95” è E10 a una pompa danese, finlandese, francese, britannica, belga o olandese, ed E5 a una polacca o tedesca — inviate `country` insieme a un nome locale. Questa è una tabella di DENOMINAZIONE ed è deliberatamente più ampia della nostra copertura dei prezzi: risponde a come si chiama un grado in un paese indipendentemente dal fatto che vi quotiamo un prezzo (per TR o MD non abbiamo alcun prezzo di stazione), e `station_level` su ogni grado indica solo quali gradi i feed delle stazioni segnalano ovunque. Passate `fuel_type` per sondare un nome e ottenere il grado canonico a cui si risolve, oppure null quando non riusciamo a individuarlo — non indoviniamo mai un grado predefinito. Ogni grado porta anche priced_countries e priced_station_counts, misurati dall'indice live delle stazioni anziché scritti a priori, così potete distinguere un nome che ACCETTIAMO per un paese (la tabella `countries`) da un grado che vi QUOTIAMO realmente; con ?country= ogni grado porta inoltre priced_here, e 0 è una risposta reale che significa che la parola della pompa esiste localmente ma nessun feed la quota.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
country | Filtro ISO-2 facoltativo — restituisce solo i nomi locali di quel paese invece di tutti e 41 (PL, DE, UA, TR, MD, …). 404 se il paese non è nella tabella. |
fuel_type | Verifica facoltativa: risolve un nome nel contesto di `country` e riporta il tipo canonico in `resolved` (es. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null significa che non siamo riusciti a collocarlo. |
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.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"
Aggiornato