Жанармай маркалары атауларының API-і Online
Әр отын өніміне негіз болатын атау кестесі: біздің канондық марка сөздігіміз (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) және әр марканың Еуропаның 41 елінде колонкада қалай аталатыны — Польшада ON және Olej napędowy, Чехияда Nafta, Венгрияда Gázolaj, Румыния мен Молдовада Motorină, Украинада ДП, Түркияда Motorin, Португалия мен Испанияда Gasóleo. Мұнда көрсетілген әр атау fuel, fuel-local, fuel-stations, fuel-cheapest және fuel-cities өнімдерінің fuel_type параметрінде қабылданады, сондықтан жүргізушінің өз сөзін тікелей бере аласыз. Анықтау ел бойынша басталады, себебі бірдей сөз әрқашан бірдей марка дегенді білдірмейді: “95” Дания, Финляндия, Франция, Ұлыбритания, Бельгия немесе Нидерланды колонкасында E10, ал Польша немесе Германия колонкасында E5 — жергілікті атаумен бірге `country`-ді жіберіңіз. Бұл — АТАУ кестесі және ол біздің баға қамтуымыздан әдейі кеңірек: ол марка сол елде бағаланатын-бағаланбайтынына қарамастан, оның сол елде қалай аталатынына жауап береді (TR немесе MD үшін бізде мүлдем станция бағасы жоқ), ал әр маркадағы station_level тек станция feed-тері қай маркалар туралы деректі қайдан да болса хабарлайтынын көрсетеді. Бір атауды тексеру үшін fuel_type жіберіңіз де, ол сәйкес келетін канондық марканы алыңыз, немесе анықтай алмасақ — null, себебі біз ешқашан әдепкі марканы болжаммен таңдамаймыз. Әр маркада жазылып қойылғаннан гөрі тікелей станциялар индексінен өлшенген priced_countries және priced_station_counts те бар, осылайша елде біз ҚАБЫЛДАЙТЫН атауды (`countries` кестесі) біз нақты сол жерде БАҒАЛАЙТЫН маркадан ажырата аласыз; ?country= арқылы әр маркада қосымша priced_here болады, ал 0 — нақты жауап, яғни колонка сөзі жергілікті түрде бар, бірақ ешбір feed оған баға қоймайды дегенді білдіреді.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— квота класы: cheap
| Параметр | Сипаттама |
|---|---|
country | Міндетті емес ISO-2 сүзгісі — барлық 41-дің орнына тек сол елдің жергілікті атауларын қайтарады (PL, DE, UA, TR, MD, …). Ел кестеде болмаса — 404. |
fuel_type | Міндетті емес тексеру: бір атауды `country` контекстінде анықтап, канондық марканы `resolved` өрісінде қайтарады (мыс. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null — оны анықтай алмағанымызды білдіреді. |
Жауап өрістері — жауап конвертіндегі data объектісінің ішінде. [] тізімді білдіреді, сондықтан data.items[].name — әр элементтің name өрісі. Мәні жоқ өріс null болады, мүлде болмайды немесе бос тізім қайтарады — толтырғышты ешқашан қоймаймыз.
| Өріс | Сипаттама |
|---|---|
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"
Жаңартылды