ईंधन ग्रेड नाम API Online
हर fuel product के पीछे की नामकरण तालिका: हमारी canonical ग्रेड शब्दावली (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 products के fuel_type parameter द्वारा स्वीकार किया जाता है, इसलिए आप driver के अपने शब्दों को सीधे पास कर सकते हैं। पहचान देश-प्रथम है क्योंकि एक ही शब्द हर जगह एक ही ग्रेड नहीं होता: डेनिश, फ़िनिश, फ़्रेंच, ब्रिटिश, बेल्जियन या डच पंप पर “95” E10 है, और पोलिश या जर्मन पंप पर E5 — स्थानीय नाम के साथ `country` भेजें। यह एक नामकरण (NAMING) तालिका है और जानबूझकर हमारी price कवरेज से अधिक व्यापक है: यह बताती है कि किसी देश में ग्रेड को क्या कहा जाता है, चाहे हम वहाँ दाम बताएँ या न बताएँ (TR या MD के लिए हमारे पास कोई भी station दाम नहीं है), और हर ग्रेड पर station_level केवल यह बताता है कि station feeds कहीं भी किन ग्रेड की रिपोर्ट करते हैं। एक नाम जाँचने के लिए fuel_type भेजें और वह canonical ग्रेड पाएँ जिससे वह मेल खाता है, या जब हम पहचान न पाएँ तो null — हम कभी किसी default ग्रेड का अनुमान नहीं लगाते। हर ग्रेड priced_countries और priced_station_counts भी रखता है, जो लिखे जाने के बजाय लाइव station इंडेक्स से मापे जाते हैं, ताकि आप उस नाम को जिसे हम किसी देश में ACCEPT करते हैं (`countries` तालिका) उस ग्रेड से अलग बता सकें जिसे हम वहाँ वास्तव में QUOTE करते हैं; ?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"
अपडेट किया गया