Подача новостей и флот NakBus теперь в партнёрской панели
Подключите свой аккаунт разработчика к аккаунту Nakordoni Partners с тем же email и управляйте там новостями и своим автобусным флотом (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"
🔑 Войдите как разработчик, чтобы протестировать этот эндпоинт вживую в песочнице — 50 бесплатных тестовых вызовов в день. Войти
Обновлено