API názvov druhov paliva Online
Tabuľka názvov stojaca za každým palivovým produktom: náš kanonický slovník značiek (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) a to, ako sa každá značka nazýva pri výdajnom stojane v 41 európskych krajinách — ON a Olej napędowy v Poľsku, Nafta v Česku, Gázolaj v Maďarsku, Motorină v Rumunsku a Moldavsku, ДП na Ukrajine, Motorin v Turecku, Gasóleo v Portugalsku a Španielsku. Každý tu uvedený názov je akceptovaný parametrom fuel_type produktov fuel, fuel-local, fuel-stations, fuel-cheapest a fuel-cities, takže môžete odovzdať formuláciu samotného vodiča priamo. Rozpoznávanie prebieha predovšetkým podľa krajiny, pretože rovnaké slovo neznamená všade rovnakú značku: „95“ je E10 pri dánskom, fínskom, francúzskom, britskom, belgickom alebo holandskom stojane a E5 pri poľskom alebo nemeckom — pošlite `country` spolu s miestnym názvom. Toto je tabuľka NÁZVOV a je zámerne širšia než naše cenové pokrytie: odpovedá, ako sa značka v krajine nazýva, bez ohľadu na to, či tam uvádzame cenu (pre TR alebo MD nemáme žiadne ceny zo staníc), a `station_level` pri každej značke iba hovorí, ktoré značky vôbec hlásia stanicové feedy. Odovzdajte `fuel_type`, ak chcete overiť jeden názov a získať kanonickú značku, na ktorú sa rozpoznáva, alebo null, ak ju nemožno určiť — nikdy neodhadujeme predvolenú značku. Každá značka nesie aj priced_countries a priced_station_counts, namerané z aktuálneho indexu staníc, nie pevne zapísané, takže viete odlíšiť názov, ktorý v krajine AKCEPTUJEME (tabuľka `countries`), od značky, ktorú tam skutočne OCEŇUJEME; s ?country= nesie každá značka navyše priced_here, pričom 0 je platná odpoveď znamenajúca, že slovo zo stojanu lokálne existuje, ale žiadny feed preň neuvádza cenu.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— trieda kvóty: cheap
| Parameter | Popis |
|---|---|
country | Voliteľný filter ISO-2 — vráti len miestne názvy danej krajiny namiesto všetkých 41 (PL, DE, UA, TR, MD, …). 404, ak krajina v tabuľke nie je. |
fuel_type | Voliteľná skúška: rozlíši jeden názov v kontexte `country` a kanonický druh vráti v poli `resolved` (napr. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null znamená, že sme ho nedokázali priradiť. |
Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.
| 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"
Aktualizované