API názvů druhů paliva Online
Tabulka názvů stojící za každým palivovým produktem: náš kanonický slovník značek (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) a to, jak se každá značka nazývá u výdejního stojanu ve 41 evropských zemích — ON a Olej napędowy v Polsku, Nafta v Česku, Gázolaj v Maďarsku, Motorină v Rumunsku a Moldavsku, ДП na Ukrajině, Motorin v Turecku, Gasóleo v Portugalsku a Španělsku. Každý zde uvedený název je přijímán parametrem fuel_type produktů fuel, fuel-local, fuel-stations, fuel-cheapest a fuel-cities, takže můžete předat formulaci samotného řidiče přímo. Rozpoznávání probíhá především podle země, protože stejné slovo neznamená všude stejnou značku: „95“ je E10 u dánského, finského, francouzského, britského, belgického nebo nizozemského stojanu a E5 u polského nebo německého — pošlete `country` společně s místním názvem. Toto je tabulka NÁZVŮ a záměrně je širší než naše cenové pokrytí: odpovídá, jak se značka v zemi nazývá, bez ohledu na to, zda tam uvádíme cenu (pro TR nebo MD nemáme žádné ceny ze stanic), a `station_level` u každé značky pouze říká, které značky vůbec hlásí stanicové feedy. Předejte `fuel_type`, chcete-li ověřit jeden název a získat kanonickou značku, na kterou se rozpoznává, nebo null, pokud ji nelze určit — nikdy neodhadujeme výchozí značku. Každá značka rovněž nese priced_countries a priced_station_counts, naměřené z aktuálního indexu stanic, nikoli pevně zapsané, takže lze odlišit název, který v zemi PŘIJÍMÁME (tabulka `countries`), od značky, kterou tam skutečně OCEŇUJEME; s ?country= nese každá značka navíc priced_here, přičemž 0 je platná odpověď znamenající, že slovo ze stojanu lokálně existuje, ale žádný feed pro něj neuvádí cenu.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
country | Volitelný filtr ISO-2 — vrátí jen místní názvy dané země místo všech 41 (PL, DE, UA, TR, MD, …). 404, pokud země v tabulce není. |
fuel_type | Volitelná zkouška: zařadí jeden název v kontextu `country` a kanonický druh vrátí v poli `resolved` (např. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null znamená, že jsme jej nedokázali zařadit. |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| Pole | Popis |
|---|---|
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"
Aktualizováno