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 безплатни тестови заявки на ден. Вход