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