Yoqilg‘i turlari nomlari API Online
Har bir yoqilg‘i mahsuloti ortidagi nomlash jadvali: bizning kanonik marka lug‘atimiz (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) va har bir markaning Yevropaning 41 mamlakatida kolonkada qanday nomlanishi — Polshada ON va Olej napędowy, Chexiyada Nafta, Vengriyada Gázolaj, Ruminiya va Moldovada Motorină, Ukrainada ДП, Turkiyada Motorin, Portugaliya va Ispaniyada Gasóleo. Bu yerda sanab o‘tilgan har bir nom fuel, fuel-local, fuel-stations, fuel-cheapest va fuel-cities mahsulotlarining fuel_type parametrida qabul qilinadi, shuning uchun haydovchining o‘z so‘zini bevosita uzatishingiz mumkin. Aniqlash avval mamlakat bo‘yicha amalga oshadi, chunki bir xil so‘z hamma joyda bir xil marka degani emas: “95” daniyalik, finlyandiyalik, fransuz, britaniyalik, belgiyalik yoki gollandiyalik kolonkada E10, polshalik yoki nemis kolonkada esa E5 — mahalliy nom bilan birga `country`ni yuboring. Bu — NOMLASH jadvali va u bizning narx qamrovimizdan ataylab kengroq: u marka shu mamlakatda narxi e'lon qilinishidan qat'i nazar, u yerda qanday nomlanishiga javob beradi (TR yoki MD uchun bizda umuman shoxobcha narxi yo‘q), har bir markadagi station_level esa faqat shoxobcha feed'lari qaysi markalar haqida qayerdadir ma'lumot berishini ko‘rsatadi. Bitta nomni tekshirish uchun fuel_type yuboring va u mos keladigan kanonik markani oling, yoki aniqlay olmasak — null, chunki biz hech qachon standart markani taxmin qilib tanlamaymiz. Har bir marka, shuningdek, oldindan yozib qo‘yilgandan ko‘ra jonli shoxobchalar indeksidan o‘lchangan priced_countries va priced_station_counts'ni o‘z ichiga oladi, shu tariqa mamlakatda biz QABUL qiladigan nomni (`countries` jadvali) biz u yerda haqiqatan NARXINI E'LON QILADIGAN markadan ajrata olasiz; ?country= bilan har bir marka qo‘shimcha ravishda priced_here'ni o‘z ichiga oladi, 0 esa haqiqiy javob bo‘lib, kolonka so‘zi mahalliy darajada mavjud, ammo hech qanday feed unga narx qo‘ymasligini bildiradi.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— kvota sinfi: cheap
| Parametr | Tavsif |
|---|---|
country | Ixtiyoriy ISO-2 filtri — barcha 41 tasi o'rniga faqat o'sha mamlakatning mahalliy nomlarini qaytaradi (PL, DE, UA, TR, MD, …). Mamlakat jadvalda bo'lmasa — 404. |
fuel_type | Ixtiyoriy tekshiruv: bitta nomni `country` kontekstida aniqlaydi va kanonik turni `resolved` maydonida qaytaradi (masalan, country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null biz uni aniqlay olmaganimizni bildiradi. |
Javob maydonlari — javob konvertidagi data obyekti ichida. [] ro‘yxatni bildiradi, ya’ni data.items[].name har bir elementning name maydonidir. Qiymatimiz bo‘lmagan maydon null bo‘ladi, umuman bo‘lmaydi yoki bo‘sh ro‘yxat qaytadi — o‘rniga hech qachon soxta qiymat qo‘ymaymiz.
| Maydon | Tavsif |
|---|---|
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"
Yangilandi