שליחת חדשות וצי NakBus נמצאים כעת בלוח השותפים
חבר את חשבון המפתח שלך לחשבון Nakordoni Partners עם אותו האימייל ונהל שם חדשות ואת צי האוטובוסים שלך (NakDriver / NakManager), עם תפקידי צוות. מפתחות ה-API, נקודות הקצה והאפליקציות שלך נשארים ללא שינוי, והדפים כאן ממשיכים לפעול. פתח את Nakordoni Partners
API של מחירי דלק לפי עיר Online
סיכום מחירי דלק לפי עיר עבור מדינה נבחרת: מחיר התחנה הזולה ביותר וממוצע 5 התחנות המובילות בכל עיר גדולה.
GET https://nakordoni.eu/api/v1/data/fuel-cities
— מחלקת מכסה: cheap
| פרמטר | תיאור |
|---|---|
country | קוד מדינה ISO-2 (חובה). מתקבלים: at, de, fr, es, it, pt, si, lu, ro, dk, hr — ro משיב כרגע ללא ערים (לא נרשמו תחנות עם מחירים) |
fuel_type | diesel (ברירת מחדל) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — הזמינות נקבעת לפי מדינה, לא לפי הפלטפורמה. קראו את `available_fuel_types` בתשובה ובחרו מתוכו; סוג שאינו מופיע ברשימה זו מחזיר מערך `cities` ריק עם `note`, ולא סוג חלופי. גם שמות מקומיים של דלק במשאבה מתקבלים — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — הם נפתרים מול `country` (או, במוצרים מבוססי קואורדינטות, מול המדינה שאליה נופלת הנקודה), כי אותו ניסוח אינו מציין את אותו סוג דלק בכל מקום: "95" הוא E10 במשאבה דנית, פינית, צרפתית, בריטית, בלגית או הולנדית, ו-E5 במשאבה פולנית או גרמנית. התשובה מחזירה את `fuel_type` (קנוני), `fuel_type_requested` (כפי שהקלדתם) ו-`fuel_type_local`. שם שאיננו מצליחים לזהות לעולם אינו מוחלף בסוג ברירת מחדל — התשובה חוזרת ריקה ומציינת זאת. טבלה מלאה של השמות לפי מדינה: /api/v2/data/fuel-grades. |
lang | קוד שפה לשמות ערים (ברירת מחדל en) |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.country | ISO-2 country, with country_name in the requested language. |
data.fuel_type | The canonical grade the prices are for. fuel_type_requested is what you sent, fuel_type_local the name a driver there uses. |
data.available_fuel_types | Grades this country actually has priced stations for — derived from the data, not a menu. Pick fuel_type from it. |
data.available_fuel_types_local | The same list keyed by grade, valued with the local pump name. |
data.cities[].city_name | City, with city_key, lat and lng. |
data.cities[].cheapest | Lowest station price in that city, with avg_price across the top stations, both in data.currency. |
data.cities[].stations[] | The stations behind those numbers: name, brand, price, lat, lng. |
data.count | Cities returned. An empty cities list with a note means the country has no price for that grade — it is never answered with a different grade. |
curl "https://nakordoni.eu/api/v1/data/fuel-cities?country=hr&fuel_type=diesel&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 התחברו כמפתחים כדי לנסות את נקודת הקצה הזו בשידור חי ב־Sandbox — 50 קריאות בדיקה חינם ביום. התחברות
עודכן