Подача новин і флот NakBus тепер у партнерській панелі
Підключіть свій обліковий запис розробника до акаунту Nakordoni Partners з тією самою електронною поштою і керуйте новинами та своїм автобусним флотом (NakDriver / NakManager) там, із ролями команди. Ваші API-ключі, ендпоінти й застосунки залишаються без змін, а сторінки тут продовжують працювати. Відкрити Nakordoni Partners
API цін на пальне за містами Online
Ціни на пальне за містами для вибраної країни: найдешевша АЗС та середня ціна по кожному великому місту. Охоплює ті ж країни, що й сторінки пального на nakordoni.eu.
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"
🔑 Увійдіть як розробник, щоб протестувати цей ендпоінт наживо в пісочниці — 50 безкоштовних тестових викликів на день. Увійти
Оновлено