Yanacaq növləri adlarının API-si Online
Hər yanacaq məhsulunun arxasında duran adlandırma cədvəli: bizim kanonik marka lüğətimiz (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) və hər markanın Avropanın 41 ölkəsində sütunda necə adlandırıldığı — Polşada ON və Olej napędowy, Çexiyada Nafta, Macarıstanda Gázolaj, Rumıniya və Moldovada Motorină, Ukraynada ДП, Türkiyədə Motorin, Portuqaliya və İspaniyada Gasóleo. Burada sadalanan hər ad fuel, fuel-local, fuel-stations, fuel-cheapest və fuel-cities məhsullarının fuel_type parametrində qəbul edilir, ona görə sürücünün öz ifadəsini birbaşa ötürə bilərsiniz. Müəyyənləşdirmə əvvəlcə ölkəyə görə aparılır, çünki eyni söz hər yerdə eyni marka demək deyil: “95” Danimarka, Finlandiya, Fransa, Böyük Britaniya, Belçika və ya Hollandiya sütununda E10-dur, Polşa və ya Almaniya sütununda isə E5 — yerli adla birlikdə `country`-ni göndərin. Bu bir ADLANDIRMA cədvəlidir və qəsdən bizim qiymət əhatəmizdən daha genişdir: o, orada qiymət bildirməyimizdən asılı olmayaraq markanın ölkədə necə adlandırıldığına cavab verir (TR və ya MD üçün ümumiyyətlə heç bir məntəqə qiymətimiz yoxdur), hər marka üzərindəki station_level isə yalnız məntəqə feed-lərinin hansısa yerdə hansı markalar barədə məlumat verdiyini göstərir. Bir adı yoxlamaq üçün fuel_type göndərin və onun uyğun gəldiyi kanonik markanı alın, ya da müəyyən edə bilmədikdə — null, çünki biz heç vaxt susmaya görə marka təxmin etmirik. Hər marka həmçinin əvvəlcədən yazılmaqdansa canlı məntəqə indeksindən ölçülmüş priced_countries və priced_station_counts daşıyır, beləliklə ölkədə QƏBUL etdiyimiz adı (`countries` cədvəli) orada faktiki olaraq QİYMƏTLƏNDİRDİYİMİZ markadan ayıra bilərsiniz; ?country= ilə hər marka əlavə olaraq priced_here daşıyır, 0 isə real cavabdır və sütun sözünün yerli olaraq mövcud olduğunu, lakin heç bir feed-in ona qiymət qoymadığını bildirir.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— kvota sinfi: cheap
| Parametr | Təsvir |
|---|---|
country | İxtiyari ISO-2 filtri — bütün 41 ölkə əvəzinə yalnız həmin ölkənin yerli adlarını qaytarır (PL, DE, UA, TR, MD, …). Ölkə cədvəldə yoxdursa — 404. |
fuel_type | Könüllü yoxlama: bir adı `country` kontekstində müəyyən edir və kanonik növü `resolved` sahəsində bildirir (məs. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null onu müəyyən edə bilmədiyimizi bildirir. |
Cavab sahələri — cavab zərfindəki data obyektinin içində. [] siyahını bildirir, yəni data.items[].name hər elementin name sahəsidir. Dəyəri olmayan sahə null olur, ümumiyyətlə görünmür və ya boş siyahı qaytarır — heç vaxt doldurucu qoymuruq.
| Sahə | Təsvir |
|---|---|
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"
Yeniləndi