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"
Обновлено