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_type של המוצרים fuel, fuel-local, fuel-stations, fuel-cheapest ו-fuel-cities, כך שניתן להעביר ישירות את הניסוח של הנהג עצמו. הזיהוי הוא מדינה-קודם, כי אותה מילה אינה אותו סוג בכל מקום: “95” הוא E10 במשאבה דנית, פינית, צרפתית, בריטית, בלגית או הולנדית, ו-E5 במשאבה פולנית או גרמנית — יש לשלוח `country` יחד עם שם מקומי. זוהי טבלת שמות (NAMING) והיא רחבה בכוונה יותר מכיסוי המחירים שלנו: היא עונה איך נקרא סוג במדינה בין אם אנחנו מתמחרים שם ובין אם לא (אין לנו בכלל מחירי תחנות עבור TR או MD), ו-station_level על כל סוג מציין רק אילו סוגים מדווחים feed-ים של תחנות איפשהו. יש להעביר fuel_type כדי לבדוק שם אחד ולקבל בחזרה את הסוג הקנוני שאליו הוא מתפענח, או null כאשר לא ניתן לזהות אותו — לעולם לא מנחשים סוג ברירת מחדל. כל סוג נושא גם priced_countries ו-priced_station_counts, הנמדדים מאינדקס התחנות החי ולא כתובים מראש, כך שניתן להבחין בין שם שאנחנו מקבלים (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"
עודכן