Üzemanyagfajta-nevek API Online
A minden üzemanyag-termék mögött álló elnevezési tábla: a kanonikus fajtaszókincsünk (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue), valamint hogy az egyes fajtákat hogyan nevezik a kútnál 41 európai országban — ON és Olej napędowy Lengyelországban, Nafta Csehországban, Gázolaj Magyarországon, Motorină Romániában és Moldovában, ДП Ukrajnában, Motorin Törökországban, Gasóleo Portugáliában és Spanyolországban. Az itt felsorolt minden nevet elfogad a fuel, fuel-local, fuel-stations, fuel-cheapest és fuel-cities termékek fuel_type paramétere, így egy sofőr saját megfogalmazását közvetlenül továbbadhatja. A feloldás elsősorban ország szerint történik, mert ugyanaz a szó nem mindenütt ugyanazt a fajtát jelenti: a „95” E10-nek számít egy dán, finn, francia, brit, belga vagy holland kútnál, és E5-nek egy lengyelnél vagy németnél — küldje el a `country`-t a helyi névvel együtt. Ez egy ELNEVEZÉSI tábla, és szándékosan szélesebb, mint az áras lefedettségünk: arra válaszol, hogy egy fajtát hogyan neveznek egy országban, függetlenül attól, hogy ott mondunk-e rá árat (TR-re vagy MD-re egyáltalán nincs állomási árunk), a `station_level` pedig minden fajtánál csak azt mondja meg, mely fajtákat jelentik egyáltalán az állomási hírfolyamok bárhol. Adja meg a `fuel_type`-ot, hogy egy nevet leteszteljen, és megkapja a kanonikus fajtát, amelyre feloldódik, vagy null-t, ha nem sikerül beazonosítani — soha nem találgatunk alapértelmezett fajtát. Minden fajta tartalmaz priced_countries-t és priced_station_counts-ot is, az élő állomásindexből mérve, nem rögzítve, így meg tudja különböztetni azt a nevet, amelyet egy országban ELFOGADUNK (a `countries` tábla), attól a fajtától, amelyet ott ténylegesen ÁRAZUNK; a ?country= paraméterrel minden fajta további priced_here értéket is kap, és a 0 valódi válasz, amely azt jelenti, hogy a kúti szó helyileg létezik, de egyetlen hírfolyam sem ad rá árat.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— kvótaosztály: cheap
| Paraméter | Leírás |
|---|---|
country | Opcionális ISO-2 szűrő — csak az adott ország helyi elnevezéseit adja vissza mind a 41 helyett (PL, DE, UA, TR, MD, …). 404, ha az ország nincs a táblázatban. |
fuel_type | Opcionális próba: egyetlen megnevezést old fel a `country` kontextusában, és a kanonikus fajtát a `resolved` mezőben adja vissza (pl. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). A null azt jelenti, hogy nem tudtuk azonosítani. |
Válaszmezők — a válaszboríték data objektumán belül. A [] listát jelöl, tehát a data.items[].name az egyes elemek name mezője. Egy mező null, hiányzik vagy üres lista, ha nincs rá értékünk — helykitöltőt soha nem teszünk oda.
| Mező | Leírás |
|---|---|
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"
Frissítve