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"
Ажурирано