საწვავის მარკების სახელების 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"
განახლდა