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` заедно с локално име. Това е таблица за ИМЕНУВАНЕ и умишлено е поширока от нашето покритие на цени: тя отговаря какво се нарича дадена марка в дадена държава, независимо дали цитираме цена там (за TR и MD изобщо нямаме цени на бензиностанции), а `station_level` при всяка марка показва само кои марки съобщават каналите на бензиностанции навсякъде. Подайте `fuel_type`, за да проверите едно име и да получите каноничната марка, до която се разрешава, или null, когато не можем да го разпознаем — никога не предполагаме марка по подразбиране. Всяка марка носи и priced_countries и priced_station_counts, измерени от живия индекс на бензиностанции, а не записани предварително, така че можете да разграничите име, което ПРИЕМАМЕ за дадена държава (таблицата `countries`), от марка, за която реално ЦИТИРАМЕ цена там; при ?country= всяка марка допълнително носи priced_here, като 0 е реален отговор, означаващ, че думата за колонка съществува локално, но никой канал не я ценообразува.
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"
Обновено