API i emrave të karburanteve Online
Tabela e emërtimeve pas çdo produkti karburanti: fjalori ynë kanonik i cilësive (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10, superplus, super100, e85, lpg, cng, lng, adblue) dhe si quhet çdo cilësi në pompë në 41 vende evropiane — ON dhe Olej napędowy në Poloni, Nafta në Çeki, Gázolaj në Hungari, Motorină në Rumani dhe Moldavi, ДП në Ukrainë, Motorin në Turqi, Gasóleo në Portugali dhe Spanjë. Çdo emër i renditur këtu pranohet nga parametri fuel_type i produkteve fuel, fuel-local, fuel-stations, fuel-cheapest dhe fuel-cities, kështu që mund të kaloni direkt shprehjen e vet shoferit. Zgjidhja bëhet fillimisht sipas vendit sepse e njëjta fjalë nuk është e njëjta cilësi kudo: “95” është E10 në një pompë daneze, finlandeze, franceze, britanike, belge ose holandeze, dhe E5 në një pompë polake ose gjermane — dërgoni `country` bashkë me një emër lokal. Kjo është një tabelë EMËRTIMI dhe qëllimisht është më e gjerë se mbulimi ynë i çmimeve: përgjigjet se si quhet një cilësi në një vend pavarësisht nëse ne citojmë çmim atje (nuk kemi fare çmime stacionesh për TR ose MD), dhe `station_level` te çdo cilësi tregon vetëm cilat cilësi raportojnë burimet e stacioneve kudo qofshin. Kaloni `fuel_type` për të testuar një emër dhe merrni cilësinë kanonike ku zgjidhet, ose null kur nuk mund ta identifikojmë — kurrë nuk hamendësojmë një cilësi të parazgjedhur. Çdo cilësi mban gjithashtu priced_countries dhe priced_station_counts, të matura nga indeksi live i stacioneve dhe jo të shkruara paraprakisht, kështu që mund të dalloni një emër që e PRANOJMË për një vend (tabela `countries`) nga një cilësi për të cilën ne vërtet CITOJMË çmim atje; me ?country= çdo cilësi mban shtesë priced_here, dhe 0 është një përgjigje reale që do të thotë se fjala e pompës ekziston lokalisht, por asnjë burim nuk e çmon.
GET https://nakordoni.eu/api/v2/data/fuel-grades
— klasa e kuotës: cheap
| Parametri | Përshkrimi |
|---|---|
country | Filtër ISO-2 opsional — kthen vetëm emrat vendorë të atij shteti në vend të të 41-ve (PL, DE, UA, TR, MD, …). 404 nëse shteti nuk është në tabelë. |
fuel_type | Provë opsionale: zgjidh një emër në kontekstin e `country` dhe raporton llojin kanonik te `resolved` (p.sh. country=PL&fuel_type=ON → diesel; country=DK&fuel_type=95 → e10; country=PL&fuel_type=95 → e5). null do të thotë se nuk arritëm ta identifikojmë. |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
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"
Përditësuar