Վառելիքի տեսակների անվանումների 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, fuel-local, fuel-stations, fuel-cheapest և fuel-cities արտադրանքների fuel_type պարամետրով, այնպես որ կարող եք ուղղակիորեն փոխանցել վարորդի սեփական ձևակերպումը։ Ճանաչումն սկսվում է երկրից, քանի որ նույն բառը ամենուր նույն տեսակը չէ․ “95”-ը դանիական, ֆիննական, ֆրանսիական, բրիտանական, բելգիական կամ հոլանդական մատակարարման կայանում E10 է, իսկ լեհական կամ գերմանական կայանում՝ E5 — ուղարկեք `country`-ն տեղական անվան հետ միասին։ Սա ԱՆՎԱՆԱՑԱՆԿ է և միտումնավոր ավելի լայն է, քան մեր գնային ընդգրկումը․ այն պատասխանում է, թե ինչպես է կոչվում տեսակը երկրում, անկախ նրանից՝ մենք այնտեղ գին հայտարարում ենք, թե ոչ (TR կամ MD երկրների համար մենք ընդհանրապես կայանային գներ չունենք), իսկ station_level-ը յուրաքանչյուր տեսակի վրա ցույց է տալիս միայն, թե որ տեսակների մասին են տվյալներ հաղորդում կայանների feed-երը որևէ տեղում։ Փոխանցեք fuel_type՝ մեկ անուն ստուգելու և ստանալու այն կանոնական տեսակը, որին այն համապատասխանում է, կամ null՝ երբ չենք կարողանում ճանաչել այն — մենք երբեք չենք գուշակում լռելյայն տեսակ։ Յուրաքանչյուր տեսակ նաև կրում է priced_countries և priced_station_counts, չափված ակտիվ կայանների ինդեքսից, այլ ոչ թե նախապես գրված, որպեսզի կարողանաք տարբերել այն անունը, որը մենք ԸՆԴՈՒՆՈՒՄ ԵՆՔ երկրում (`countries` աղյուսակը), այն տեսակից, որը մենք փաստացի ՀԱՅՏԱՐԱՐՈՒՄ ԵՆՔ այնտեղ; ?country=-ով յուրաքանչյուր տեսակ լրացուցիչ կրում է priced_here, և 0-ն իրական պատասխան է, որը նշանակում է, որ մատակարարման կայանի բառը գոյություն ունի տեղում, բայց ոչ մի feed դրա գին չի հայտարարում։
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"
Թարմացվել է