Yakıt türü adları API Online
Her yakıt ürününün arkasındaki adlandırma tablosu: kanonik sınıf sözlüğümüz (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) ve her sınıfın 41 Avrupa ülkesinde pompada nasıl adlandırıldığı — Polonya'da ON ve Olej napędowy, Çekya'da Nafta, Macaristan'da Gázolaj, Romanya ve Moldova'da Motorină, Ukrayna'da ДП, Türkiye'de Motorin, Portekiz ve İspanya'da Gasóleo. Burada listelenen her ad, fuel, fuel-local, fuel-stations, fuel-cheapest ve fuel-cities ürünlerinin fuel_type parametresi tarafından kabul edilir, böylece bir sürücünün kendi ifadesini doğrudan geçirebilirsiniz. Çözümleme önce ülkeye göre yapılır çünkü aynı kelime her yerde aynı sınıf değildir: “95”, Danimarka, Finlandiya, Fransa, İngiltere, Belçika veya Hollanda pompasında E10'dur ve Polonya veya Almanya pompasında E5'tir — yerel bir adla birlikte `country` gönderin. Bu bir ADLANDIRMA tablosudur ve kasıtlı olarak fiyat kapsamamızdan daha geniştir: orada fiyat verip vermediğimize bakılmaksızın bir sınıfın bir ülkede nasıl adlandırıldığını yanıtlar (TR veya MD için hiç istasyon fiyatımız yoktur) ve her sınıf üzerindeki `station_level` yalnızca hangi sınıfların istasyon beslemeleri tarafından herhangi bir yerde bildirildiğini gösterir. Bir adı sınamak ve çözümlendiği kanonik sınıfı geri almak için `fuel_type` gönderin, ya da yerleştiremediğimizde null — varsayılan bir sınıfı asla tahmin etmeyiz. Her sınıf ayrıca, önceden yazılmak yerine canlı istasyon dizininden ölçülen priced_countries ve priced_station_counts taşır, böylece bir ülke için KABUL ettiğimiz bir adı (`countries` tablosu) orada gerçekten FİYATLANDIRDIĞIMIZ bir sınıftan ayırt edebilirsiniz; ?country= ile her sınıf ayrıca priced_here taşır ve 0, pompa kelimesinin yerel olarak var olduğu ama hiçbir beslemenin onu fiyatlandırmadığı anlamına gelen gerçek bir yanıttır.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— kota sınıfı: cheap
| Parametre | Açıklama |
|---|---|
country | İsteğe bağlı ISO-2 filtresi — 41 ülkenin tamamı yerine yalnızca o ülkenin yerel adlarını döndürür (PL, DE, UA, TR, MD, …). Ülke tabloda yoksa 404. |
fuel_type | İsteğe bağlı sınama: bir adı `country` bağlamında çözümler ve kanonik yakıt türünü `resolved` alanında bildirir (ör. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null, adı yerleştiremediğimiz anlamına gelir. |
Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.
| Alan | Açıklama |
|---|---|
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"
Güncellendi