API-ի փոփոխությունների ամսագիր

toll-cost ապրանքն այժմ հաշվում է նաև թեթև մեքենաների արժեքը։ Ուղարկեք "vehicle": {"class": "car"}։

• Թեթև մեքենայի դաս՝ մենք հաշվում ենք երթուղու վճարովի կետերը և վինյետ ունեցող յուրաքանչյուր երկրի ամենաէժան վինյետը (օրինակ՝ AT և HU 1-օրյա վինյետները)։ Միջանկյալ կետերի դեպքում հաշվում ենք թեթև մեքենայի երթուղի։
• Պատասխան՝ by_country[]-ը տալիս է cost_eur, gates_eur, vignette_eur և vignette_name։ Գանձվող յուրաքանչյուր վճարովի կետ gate տիպի տարր է։ Թեթև մեքենաների համար toll_km-ը null է։
• Լռելյայն՝ առանց class-ի կամ "class": "hgv"-ի դեպքում ապրանքը բեռնատարները հաշվում է ինչպես նախկինում։ Թեթև մեքենաների համար axles, gross_weight_t, euro և co2_class չեն օգտագործվում։

Փաստաթղթեր՝ Truck Toll Cost.

v3 տարբերակը truck-route-ի համար այժմ փաստաթղթավորված է: Այն հասանելի է GET https://api.nakordoni.dev/v3/truck-route հասցեով և GET /api/v3/data/truck-route հասցեով: Այն ընդունում է հարցման նույն պարամետրերը, ինչ v2-ը: Այն ունի նաև v3-ի պատասխանի դաշտերը 2026-10-22-ից՝ հանգստի կանգառների կանոնները և eCherha սահմանային սպասումը:

• Երթուղին սկզբում հաշվարկվում է մեր նվիրված երթուղավորման սերվերում: Եթե այդ սերվերը ժամանակին չի պատասխանում, երթուղին հաշվարկում է մեր հիմնական սերվերը: Պատասխանի ձևաչափը նույնն է:
• X-Route-Source պատասխանի վերնագիրը ցույց է տալիս, թե որ սերվերն է պատասխանել՝ primary կամ fallback:
• Նույն API բանալին և քվոտայի նույն դասը, ինչ v2-ում՝ route, 1 միավոր մեկ կանչի համար:

v2-ի աջակցությունը շարունակվում է, և այն չի փոխվում: v3-ին անցնելու համար փոխեք տարբերակը ձեր հարցման URL-ում:

Փաստաթղթեր՝ Truck Route API v3:

v4: plate-recognition-ի (POST /api/v4/data/plate-recognition) տարբերակն ընդունում է հարցման նոր ընտրովի տարբերակներ։ Առանց դրանց v4-ի արդյունքը չի փոխվում։

• regions. ակնկալվող երկրները ISO կոդերով (օրինակ՝ ["PL","DE"])։ Երկրի կանխատեսումը և ընթերցումների հերթականությունը թեքվում են դեպի այդ երկրները։
• camera_id և timestamp. վերադարձվում են անփոփոխ՝ data.camera_id և data.timestamp դաշտերում։ Դրանք չեն պահվում հարցումների սովորական մատյանից դուրս։
• config.threshold. այս արժեքից ցածր գնահատական ունեցող արդյունքները բաց են թողնվում։
• config.mode. fast բաց է թողնում տրանսպորտային միջոցի հայտնաբերումը, v2-ին մոտ արագության համար։ region-ը շարունակում է լրացվել, իսկ vehicle-ը null է։

Տարբերակները ուղարկեք JSON մարմնում, որպես multipart դաշտեր կամ որպես հարցման պարամետրեր։ 400 սխալների նոր կոդեր. bad_regions, bad_camera_id, bad_timestamp, bad_config, bad_threshold, bad_mode։ v2-ը չի փոխվում և անտեսում է տարբերակները։

Փաստաթղթեր. Plate Image Recognition v4։

Նոր v4 տարբերակ՝ plate-recognition (POST /api/v4/data/plate-recognition)։ Այն լրացնում է երկու դաշտ, որոնք v2-ը միշտ վերադարձնում է որպես null՝

• results[].region: համարանիշի ISO երկրի կոդով {code, score} (օրինակ՝ UA), կարդացվում է համարանիշի ձևաչափից։ Երբ մի քանի երկիր օգտագործում է նույն ձևաչափը, score-ը ցածր է։
• results[].vehicle: համարանիշը կրող տրանսպորտային միջոցի {type, score, box}։ type-ը լինում է car, bus, truck կամ motorcycle։

Հարցումը, մյուս դաշտերը և սխալի կոդերը չեն փոխվում։ v4-ը v2-ից ավելի երկար է աշխատում տրանսպորտային միջոցի հայտնաբերման պատճառով (սովորաբար 0.5-1.5 s մեկ պատկերի համար)։ v2-ը չի փոխվում և երկու դաշտի համար էլ շարունակում է վերադարձնել null։

Փաստաթղթեր՝ Plate Image Recognition v4.

Նոր արտադրանք plate-recognition (POST /api/v2/data/plate-recognition). Այն կարդում է համարանիշերը մեքենայի լուսանկարում։ Շարժիչը մեր սեփական համարանիշերի դետեկտորն ու ընթերցիչն է՝ կարգավորված եվրոպական բեռնատարների և ավտոբուսների վրա։

• Մուտք: մեկ պատկեր (JPEG, PNG, WebP, BMP կամ TIFF, առավելագույնը 8 ՄԲ) որպես JSON image_url կամ image_base64, որպես multipart վերբեռնում դաշտում image, կամ որպես հում բայթեր image/* Content-Type-ով։
• Ելք: results[] հետևյալով՝ plate, score, candidates[], region, box, dscore և vehicle, ինչպես նաև processing_time ms-ով։
• Սխալներ: 400 պատկերը բացակայում է կամ անվավեր է, 404 no_plate_detected, 413 պատկերը 8 ՄԲ-ից մեծ է, 500 engine_error.
• Գաղտնիություն: պատկերները մշակվում են հիշողության մեջ և երբեք չեն պահվում։ image_url պետք է լինի հանրային հասցե. մասնավոր և ներքին հասցեները, ինչպես նաև դրանց վերահղումները, մերժվում են։

Ստանդարտ նույնականացում բանալիով, քվոտայի դաս heavy։ Հասանելի է /api/v2/-ից. գոյություն ունեցող ոչ մի endpoint չի փոխվել։

Նոր արտադրանք lane-cost-index (GET /api/v2/data/lane-cost-index). Այն վերադարձնում է Եվրոպայում A-ից B մեկ բեռնված բեռնատարային ուղևորության ծախսերի ինդեքսը՝ վառելիք, ճանապարհավճարներ, վարորդի ժամանակ և օրապահիկ։

• Մուտքային տվյալներ: from և to՝ որպես "lat,lng" կամ քաղաքի id, vehicle (օրինակ՝ artic_40t), ըստ ցանկության euro, co2_class և empty_return։
• Ըստ երկրների: կմ, ճանապարհավճար, դիզելի լիտրեր և վառելիքի ծախս (առանց ԱԱՀ), ինչպես նաև ճանապարհավճարի համար կիրառված տրանսպորտային միջոցի դասը։
• Վարորդի ժամանակ: վարումը, ընդմիջումները և հանգիստը համապատասխանում են ԵՄ 561/2006 կանոններին։ Վարորդի ծախսը և օրապահիկը հաշվարկվում են մեկնման երկրի դրույքով։ Իսպանիան և Իտալիան այժմ ունեն վարորդի դրույք և օրապահիկ՝ կոլեկտիվ պայմանագրերից։
• Միտում: trend-ը տալիս է ընթացիկ և նախորդ երկու ամիսների ծախսերի ինդեքսը։
• Ոչ ամբողջական տվյալներ: երբ երթուղու վրա գտնվող երկրի համար չկան ճանապարհավճարի կամ վառելիքի տվյալներ, կամ մեկնման երկիրը չունի վարորդի դրույք, incomplete-ը true է, և գումարը ստորին սահման է։ missing_countries-ը և missing_components-ը ցույց են տալիս, թե ինչն է պակասում։

Սա ծախսերի ինդեքս է, ոչ թե փոխադրման գին․ տրանսպորտային միջոցի կապիտալը, ապահովագրությունը, վերադիր ծախսերը և մարժան ներառված չեն։

Քվոտա՝ մեկ հարցումը հաշվվում է որպես route դասի 1 միավոր, ինչպես truck-route-ը։

Փաստաթղթեր: Lane Cost Index.

toll-cost արտադրանքն այժմ ավելի ճշգրիտ է հաշվարկում Ֆրանսիան, Իսպանիան և Իտալիան։

• Ֆրանսիա և Իսպանիա: երթուղու վրա երկու վճարովի կետերի միջև մայրուղու հատվածը հաշվարկվում է մայրուղու օպերատորի մուտքի/ելքի սակագնով։ Այն ցուցադրվում է որպես տարրի նոր տեսակ՝ motorway_section, օպերատորով կամ ճանապարհով, երկու կետերով, toll_km և cost_eur արժեքներով։ Երկրի մնացած վճարովի կմ-երը դեռ օգտագործում են մեկ կմ-ի միջին դրույքը։
• Տրանսպորտային միջոցի դաս: Ֆրանսիա՝ 3-րդ դաս 2 առանցքի համար և 4-րդ դաս 3 կամ ավելի առանցքի համար։ Իսպանիա՝ Pesados 1 2 կամ 3 առանցքի համար և Pesados 2 4 կամ ավելի առանցքի համար։
• Իտալիա: 2 և 3 առանցքով բեռնատարներն այժմ ունեն մեկ կմ-ի իրենց դրույքները։
• Euro և CO2 դաս: Ֆրանսիայի, Իտալիայի և Իսպանիայի սակագները կախված չեն այս դասերից։ Երբ ուղարկում եք euro կամ co2_class, class_fallback այս երկրների համար false է, իսկ class_note նշում է պատճառը։
• Առանց վճարովի ճանապարհի: Իսպանիայով առանց վճարովի ճանապարհի երթուղին (օրինակ՝ Սարագոսա – Բարսելոնա) վերադարձնում է Իսպանիան cost_eur 0 և scheme not_tolled արժեքներով։

Մյուս երկրները չեն փոխվում։ Փաստաթղթեր՝ Truck Toll Cost.

Նոր արտադրանք toll-cost (POST /api/v2/data/toll-cost, JSON մարմին)։ Այն վերադարձնում է Եվրոպայով անցնող երթուղու վրա բեռնատարի ճանապարհավճարի արժեքը։

• Մուտքային տվյալներ: երթուղու գիծը՝ որպես coordinates (օրինակ՝ truck-route-ի երկրաչափությունը), կամ waypoints, որոնց համար երթուղին կառուցում ենք մեր բեռնատարային երթուղավորմամբ։
• Տրանսպորտային միջոց: axles, gross_weight_t, euro և co2_class։ Ըստ ցանկության՝ date սակագների համար և currency ընդհանուր գումարի համար։
• Ըստ երկրների: վճարովի կմ, փաստացի դրույքը EUR-ով մեկ կմ-ի համար, արժեքը, սակագնված դասը և սակագնի ամսաթիվը։ Euro և CO2 կոնկրետ դասի դրույքներն օգտագործվում են այնտեղ, որտեղ այդ դասի համար պաշտոնական սակագին կա։ Հակառակ դեպքում օգտագործվում է լռելյայն դասի դրույքը, և class_fallback-ը true է։
• Առանձին կետեր: մայրուղիների կոնցեսիոն հատվածներ, ինչպես նաև թունելներ և կամուրջներ՝ բեռնատարների համար առանձին վճարով (օրինակ՝ Կալաֆատ-Վիդին)։

Քվոտա՝ մեկ հարցումը հաշվվում է route դասի 1 միավոր, ինչպես truck-route-ը։

Փաստաթղթեր: Truck Toll Cost.

Երկու նոր արտադրանք՝ /api/v2։ Ավտոբուսով ուղևորության համար դրանք ցույց են տալիս, թե որ կողմն է արևի տակ և որը ստվերում, և որ նստատեղերն են լավագույնը ստվերի կամ տեսարանի համար։

• bus-sun-side (/api/v2/data/bus-sun-side), GET՝ երթուղի մեր ավտոբուսային երթուղիների ռեեստրից (route_id, dir, date) կամ ազատ ուղևորություն (from, to, depart)։
• bus-sun-side, POST՝ ուղարկեք ձեր երթուղին որպես կանգառների ցուցակ, GeoJSON գիծ կամ կոդավորված պոլիգիծ։ Ավելացրեք ավտոբուսի պարամետրերը (շարքեր, նստատեղերի դասավորություն, դռան կողմ, պատուհաններ, հարկ) կամ ընտրեք մոդել կատալոգից՝ bus_model։
• Եղանակ՝ առաջիկա 3 օրվա ուղևորությունների համար օգտագործվում է ժամային կանխատեսումը երթուղու երկայնքով։ Ավելի ուշ ուղևորությունները հաշվարկվում են պարզ երկնքի համար։ Ուղարկեք weather=0, որպեսզի միշտ ստանաք պարզ երկնքի արդյունքը։
• Պատկերներ (POST)՝ նստատեղերի սխեմա, երթուղու քարտեզ և ժամանակագրություն որպես URL PNG, WebP կամ JPG ձևաչափով։ Պատկերները պահվում են 12 ժամ։ Դուք ստանում եք նաև embed_html արդյունքը ձեր էջում ցուցադրելու համար։ Պատկերների URL-ները սկսվում են https://api.nakordoni.dev/images/-ով։
• Անիմացիա՝ animation բլոկը պարունակում է կադր յուրաքանչյուր 5 րոպեն մեկ՝ ավտոբուսի դիրքով, ուղղությամբ, արևի ազիմուտով և բարձրությամբ և արևոտ կողմով, ձեր լեզվով պիտակներով, ըստ կողմերի ամփոփումներով և լեգենդով։ Ուղարկեք animation=0 այն բաց թողնելու համար։
• Վիջեթ՝ ցուցադրեք արդյունքը ցանկացած կայքում, այդ թվում WordPress-ում, script թեգով կամ iframe-ով։ Վիջեթն օգտագործում է հրապարակային բանալի, որն աշխատում է միայն ձեր թույլատրած դոմեններում (origins), և մեր սեփական քարտեզի սալիկները։ Հասանելի է WordPress հավելված (zip)։
• bus-sun-catalog (/api/v2/data/bus-sun-catalog)՝ ավտոբուսի մոդելները, որոնք ընդունում է bus-sun-side-ը, նստատեղերի դասավորությամբ և պատուհաններով։

Քվոտա՝ պատկերներով POST հարցումը հաշվվում է 2 միավոր։ Մնացած բոլոր հարցումները՝ 1 միավոր։

Փաստաթղթեր: Bus Sun Side.

fleet-compliance-validate-ը այժմ ընդգրկում է EU 561/2006 կանոնակարգի ավելի մեծ մասը՝ ինչպես փոփոխվել է Կանոնակարգով (EU) 2020/1054։ Գոյություն ունեցող պատասխանի դաշտերը չեն փոխվում, ավելացվում են նոր դաշտեր։

• Art. 12 բացառություն. վարելու գործողությունները նշեք art12_exceed: true-ով։ Բացառիկ դեպքերում վարորդը կարող է գերազանցել վարելու օրական և շաբաթական սահմանաչափերը մինչև 1 ժ՝ շաբաթական հանգստի համար գործառնական կենտրոն կամ տուն հասնելու նպատակով, կամ մինչև 2 ժ՝ 30 րոպե ընդմիջումից հետո, երբ հաջորդում է կանոնավոր շաբաթական հանգիստ։ Վալիդատորը դա ընդունում է և վերադարձնում է հատուցման ենթակա ժամանակը և դրա վերջնաժամկետը (հաջորդ երրորդ շաբաթվա ավարտը)՝ remaining.driving.art12_compensation և exceptions.art12 դաշտերում։
• Art. 8(8a) վերադարձ բազա. շաբաթական հանգստի դեպքում ուղարկեք location (residence, operational_centre կամ elsewhere)։ Եթե 4 անընդմեջ շաբաթ տանը կամ գործառնական կենտրոնում կանոնավոր շաբաթական հանգիստ չկա, կստանաք նախազգուշացում։
• Art. 8(6a) 12-օրյա շեղում. passenger_12day: true՝ մեկ պատահական միջազգային ավտոբուսային փոխադրման համար։ Այդ դեպքում շաբաթական հանգիստը կարող է սկսվել կանոնավոր շաբաթական հանգստից հետո մինչև տասներկու 24-ժամանոց ժամանակահատվածից։ Դրանից հետո հանգիստները և գիշերային վարելը (22:00-06:00) ստուգվում են։ AETR Art. 8(6)(b)-ը կիրառվում է նույն կերպ։
• Ազգային գիշերային պատուհաններ (Директива 2002/15/EC Art. 3(h)). ազգային գիշերային ժամանակահատվածը կիրառելու համար օգտագործեք country կամ wtd.country։ Ստուգված են՝ AT, IE (ուղևորների համար առանձին) և SE։ ԵՄ/ԵՏԶ այլ երկրները օգտագործում են 00:00-04:00 և վերադարձնում են night_window_verified: false։
• fleet-compliance-limits. AETR-ն այժմ թվարկում է 2010 թվականից հետո ստուգված փոփոխությունները։ Դրանք փոխում են միայն Article 14-ը, ոչ թե վարելու կամ հանգստի կանոնները։

Փաստաթղթեր՝ Fleet Compliance։

Չորս նոր արտադրանք, որոնք մատուցվում են /api/v2-ից և հաշվարկվում են մեր սեփական տոների կանոնների շարժիչով 51 երկրի համար (Եվրոպա և Պարսից ծոց՝ SA, AE, QA, KW, BH, OM), 2020-2035.

• holiday-calendar-holidays (/api/v2/data/holiday-calendar/holidays) — պետական, բանկային, տարածաշրջանային, կրոնական և հիշատակի տոներ մինչև 10 երկրի համար՝ տարվա կամ ամսաթվերի միջակայքի կտրվածքով։ Յուրաքանչյուր տոն նշում է՝ արդյոք այն հանգստյան օր է, բանկային տոն է կամ ընկնում է դպրոցական արձակուրդների մեջ, տեղափոխվել է արդյոք հանգստյան օրվա տոնը մեկ այլ օր, իսլամական օրացույցի ամսաթիվը դեռ գնահատված է արդյոք, և այդ օրը կիրառվում է արդյոք բեռնատարների երթևեկության արգելք (truck_ban)։ Զտեք ըստ տարածաշրջանի (region=DE-BY), տեսակի, լեզվի և անվանման; school=1-ը ավելացնում է դպրոցական արձակուրդները։
• holiday-calendar-business-days (/api/v2/data/holiday-calendar/business-days) — հաշվարկեք աշխատանքային օրերը երկու ամսաթվերի միջև, ավելացրեք կամ հանեք աշխատանքային օրեր, ստուգեք ամսաթիվը կամ գտեք հաջորդ կամ նախորդ աշխատանքային օրը։ Օգտագործվում են երկրի հանգստյան օրերը (շաբաթ-կիրակի, կամ ուրբաթ-շաբաթ և այլ հանգստյան օրեր Պարսից ծոցում), ազգային և տարածաշրջանային ոչ աշխատանքային օրերը և հրամանագրով օրերի տեղափոխությունները։
• holiday-calendar-countries (/api/v2/data/holiday-calendar/countries) — ընդգրկված երկրները՝ հանգստյան օրերով, ժամային գոտիով, տարածաշրջաններով և տոների տեսակներով; country=-ի դեպքում նաև տարեկան աշխատանքային օրերը և հաջորդ հինգ տոները։
• holiday-calendar-impact (/api/v2/data/holiday-calendar/impact, Pro պլան և բարձր) — մոդելով գնահատված բիզնես-ազդեցություն՝ ազդեցության գնահատական 0-100 յուրաքանչյուր տոնի համար, խանութների փակման հավանականություն, պահանջարկի կատեգորիաներ, երկար հանգստյան օրերի և կամրջային օրերի դիրք, և պահանջարկի աճի պատուհաններ։ holiday-calendar-holidays-ում Pro և ավելի բարձր պլանները նույնպես ստանում են այս բլոկը include=impact-ով և կարող են զտել min_impact-ով։

Գոյություն ունեցող holiday-calendar արտադրանքը չի փոխվում։ Փաստաթղթեր՝ Holiday Calendar։

Երեք նոր արտադրանք վարման ժամանակի համապատասխանության համար, որոնք մատուցվում են /api/v2-ից՝

• fleet-compliance-validate (POST /api/v2/data/fleet/compliance/validate, JSON մարմին) — ստուգում է վարորդի գրանցված գործունեությունը EU 561/2006 կամ AETR և Directive 2002/15/EC աշխատանքային ժամանակի համաձայն։ Այն վերադարձնում է յուրաքանչյուր խախտումը՝ կանոնի հոդվածով և խստության շեմով, ինչպես նաև այն, ինչ վարորդին այս պահին մնացել է՝ օրական վարում, շարժվող 56 ժ շաբաթական և 90 ժ երկշաբաթյա սահմանաչափեր, հաջորդ ընդմիջումը, օրական և շաբաթական հանգիստը։ Այն ընդգրկում է բաժանված ընդմիջումները, կրճատված և երկարացված օրերը, կրճատված շաբաթական հանգստի փոխհատուցումը, գիշերային աշխատանքը, կրկնակի անձնակազմը և լաստանավով կամ գնացքով ընդհատված հանգիստը։
• fleet-compliance-limits (/api/v2/data/fleet/compliance/limits) — EU 561, AETR (561-ից իր տարբերություններով) և 2002/15 կանոնների պարամետրերը, ինչպես նաև Regulation (EU) 2016/403 խստության շեմերը։
• fleet-compliance-plan-check (POST /api/v2/data/fleet/compliance/plan-check, JSON մարմին) — ստուգում է պլանավորված հերթափոխերը մինչև ուղարկումը՝ ըստ ուղևորության երկրներում բեռնատարների երթևեկության արգելքների, պետական տոների և հանգստյան օրերի, ինչպես նաև EU 561, AETR և 2002/15 կանոնների։ Յուրաքանչյուր հերթափոխի համար տրվում է ամենավաղ օրինական մեկնարկի ժամանակը։

Փաստաթղթեր՝ Fleet Compliance։

v3-ից օրական և շաբաթական հանգստի կանգառներն ունեն in_vehicle_allowed, accommodation_required և rule դաշտերը (route-plan rest_rules=eu561-ով և truck-route): (ԵՄ) 2020/1054 կանոնակարգը փոխեց EU 561/2006-ի 8-րդ հոդվածի 8-րդ մասը. կանոնավոր շաբաթական հանգիստը և 45 ժամից ավելի ցանկացած շաբաթական հանգիստ չի կարելի անցկացնել տրանսպորտային միջոցում: Այս կանգառների համար in_vehicle_allowed = false: Կրճատված շաբաթական հանգիստը (24 ժամից մինչև 45 ժամից պակաս) և օրական հանգիստը կարելի է անցկացնել քնելու տեղով կանգնած տրանսպորտային միջոցում:

Շաբաթական հանգստի կանգառներն ունեն նաև accommodation[]՝ կանգառի մոտ տեղում սենյակներով կայանատեղիներ, իսկ կանգառի կայանատեղին ունի has_accommodation: Սա միայն տեղեկություն է. կանգառը, դրա ժամը և բեռնատարների կայանատեղին չեն փոխվում: Եթե սենյակներով վայր հայտնի չէ, կանգառն ունի warning = no_accommodation_found: v1 և v2 պատասխանները չեն փոխվում:

/api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest, /api/v2/data/fuel-local և mode=nearest-ով /api/v2/data/fuel կայանների գներն այժմ ունեն առավելագույն տարիք՝ 90 օր։ Այն գինը, որը մենք վերջին անգամ հաստատել ենք ավելի քան 90 օր առաջ, այլևս չի վերադարձվում։ Նախկինում նման գինը վերադարձվում էր stale = true-ով։

Ինչ է փոխվում պատասխաններում. վառելիքի տեսակը, որն ունի միայն ավելի հին գին, բացակայում է prices-ում. առանց մնացած գնի կայանը ցուցակում չէ կամ ունի դատարկ prices օբյեկտ այնտեղ, որտեղ ցուցադրվում են առանց գնի կայաններ. իսկ պատասխանը կարող է դատարկ լինել այնտեղ, որտեղ նախկինում հին գներ կային։ Դատարկ պատասխանը, ինչպես միշտ, պարունակում է empty_reason։ Այդ դեպքում fuel-local-ը կարող է պատասխանել տարածաշրջանի կամ երկրի մակարդակից։ stale դրոշը չի փոխվում. այն true է, երբ գինը վերջին անգամ հաստատվել է ավելի քան 7 օր առաջ։ Գների պատմությունը պահպանվում է։ fuel-cities, fuel-cost, ազգային միջին գների և fuel-grades-ի համար գործնական փոփոխություն չկա։ Մանրամասներ. Գնի տարիքը։

GET /api/v2/data/route-plan-ը v2-ում ստանում է կանգառների ընդլայնված մոդել (միայն լրացումներ՝ ոչինչ չի հանվել կամ վերանվանվել) և նոր լռելյայն արժեքներ v3-ում (/api/v3/data/route-plan):

v2, լրացուցիչ։ stop_places=1-ով յուրաքանչյուր կանգառ (ընդմիջում, ճաշ, գիշերակաց, շաբաթական հանգիստ) պարունակում է places[]՝ թեկնածու կայանատեղիներ կանգառի շուրջ վարման ժամանակի պատուհանում, յուրաքանչյուրը name, type, country, lat, lon, at_km, at_drive_s, offset_min, off_route_km, detour_km, exceeds_4h30 և type_rank դաշտերով։ Որոնումը կարգավորեք places_before_min, places_after_min, places_radius_km և rest_radius_km-ով. 25 կմ-ից մեծ շառավիղը սահմանափակվում է և հայտնվում է radius_clamped նախազգուշացմամբ։ rest_rules=legacy|eu561-ը ընտրում է հանգստի մոդելը, իսկ eu561-ով կարող եք ուղարկել վարորդի վիճակը՝ driven_since_break_min, driven_today_min, duty_started_min_ago, driven_week_min, driven_fortnight_min, extended_days_used, reduced_rests_used և allow_reduced։ Կանգառների նոր տեսակներ՝ ban_wait (ban-ով՝ name, country, from, until) և weekly_rest. ընդմիջումը կամ հանգիստը փոխարինող սպասումը նշվում է counts_as-ով։ Ուկրաինայից դուրս գալու էլեկտրոնային հերթով բեռնատարների անցակետերը ավելացնում են registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note և registration_url դաշտերը, ինչպես նաև echerha_registration և echerha_wait_unverified նախազգուշացումները։

v3, նոր լռելյայն արժեքներ։ rest_rules-ը լռելյայն eu561 է. վայրերի անունները խիստ են (միայն իրական կայանատեղիներ և հանգստի վայրեր). eCherha-ի հրապարակած սպասման ժամանակը (թարմ տվյալներ, առանց սահմանափակման) օգտագործվում է որպես սահմանային սպասում, իսկ սահմանային սպասումը հաշվվում է որպես հասանելի ընդմիջում կամ հանգիստ։ v2-ը պահպանում է հին հանգստի մոդելը և վայրերի սկզբնական զտիչը, ուստի առկա ինտեգրացիաները չեն փոխվում։ Մանրամասներ՝ Route Planner API։

GET /api/v3/data/truck-route-ը այժմ օգտագործում է eCherha-ի սպասումը սահմանին։ v3-ում Ուկրաինայից դուրս գալու էլեկտրոնային հերթով բեռնատար գծերի border_crossings[]-ը wait_min-ը վերցնում են eCherha-ի հրապարակած սպասման ժամանակից (միայն թարմ տվյալներ, առանց սահմանափակման. եթե հնացած է, wait_min-ը null է և ավելանում է echerha_wait_unverified նախազգուշացումը) և պարունակում են registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note և registration_url, echerha_registration նախազգուշացմամբ։

Հանգստի պլանը սահմանային սպասումը դիտարկում է որպես սահմանին անցկացրած ժամանակ. երկար հերթը հաշվվում է որպես հասանելի ընդմիջում, օրական կամ շաբաթական հանգիստ (counts_as waits[] տողում), այլ ոչ թե ավելանում է վրայից։ v2-ը անփոփոխ է։ Մանրամասներ՝ Truck Route API։

Երբ /api/v2/data/fuel-stations կամ /api/v2/data/fuel-cheapest ոչ մի լցակայան չի գտնում, պատասխանը միևնույն է HTTP 200 է՝ դատարկ ցանկով, և հիմա նշում է նաև պատճառը։ Միայն դատարկ պատասխանում data-ն պարունակում է empty_reason (no_station_in_radius, no_price_for_fuel_type, fuel_type_not_priced_in_country, unknown_fuel_type կամ no_fresh_price_in_radius), nearest_station_km (ձեր տեսակն առաջարկող մոտակա լցակայանը, որոնումը մինչև nearest_search_km = 50 կմ. null, եթե չկա), country և suggestion՝ մեկ կարճ նախադասություն ձեր lang-ով, օրինակ՝ 5 կմ-ի սահմաններում լցակայան չկա. մոտական 6,4 կմ հեռավորության վրա է. փորձեք radius_km=10։

Ձեր կոդի ճյուղավորումը կատարեք ըստ empty_reason-ի և nearest_station_km-ի։ suggestion-ը խորհուրդ է մարդկանց համար, և դրա ձևակերպումը կարող է փոխվել։ Շառավիղը ձեր փոխարեն երբեք չենք մեծացնում։ Եթե տարածքը կամ երթուղին նմուշառում եք ցանցով, օգտագործեք radius_km 10–15։ Լցակայաններ պարունակող պատասխանները չեն փոխվել։ Մանրամասներ՝ Դատարկ պատասխաններ։

Որոնման շառավիղ։ /api/v2/data/fuel-stations-ում radius_km-ն այժմ պահպանում է մեկ տասնորդական նիշ։ 4.8-ի նման շառավիղը նախկինում առանց ծանուցման կրճատվում էր մինչև 4, ուստի յուրաքանչյուր որոնում ընդգրկում էր պահանջվածից մինչև մեկ երրորդով փոքր տարածք և կարող էր վերադարձնել ավելի քիչ լցակայան կամ ոչ մեկը։ anchor.radius_km-ը ցույց է տալիս իրականում կիրառված շառավիղը. ամբողջ թվերը վերադարձվում են ինչպես նախկինում։

Ապրանքանիշերի անվանումներ։ Նույն ապրանքանիշը հիմա brand-ում միշտ գրվում է նույն կերպ, օրինակ՝ ORLEN-ը և orlen-ը վերադարձվում են որպես Orlen, իսկ CircleK-ը՝ որպես Circle K։ Լցակայանները, գները, ID-ները և դաշտերը չեն փոխվել։ Եթե ապրանքանիշերը համեմատում եք ճշգրիտ գրությամբ (լոգոների կամ ֆիլտրերի համար), ստուգեք ձեր ցանկը նոր անվանումների համեմատ։

GET /api/v2/data/truck-route-ն ընդունում է նոր ընտրովի traffic պարամետրը։ Այն սահմանում է, թե ինչպես է երթևեկությունը հաշվի առնվում ETA-ի, հանգստի պլանի, սահմանին հասնելու ժամերի և բեռնատարների արգելքների ժամերի համար.

• forecast (լռելյայն). կրկնվող խցանումները այն ժամին, երբ բեռնատարն անցնում է յուրաքանչյուր հատվածով, ընթացիկ խցանումները, որոնք մարում են հասնելու ժամանակի հետ, ճանապարհային աշխատանքները և փակումները երթուղու վրա, և եղանակը, որտեղ այն ունենք։ Պատասխանը պարունակում է traffic_forecast բլոկ՝ ըստ պատճառի բաժանված ուշացմամբ։
• live. միայն ընթացիկ երթևեկությունը՝ առանց կրկնվող խցանումների։
• off. առանց երթևեկության ճշգրտման. ժամանակները բեռնատարի համար ազատ ընթացքի հաշվարկի ժամանակներն են։ Այդ դեպքում traffic_forecast-ը պարունակում է միայն model և mode։

Ցանկացած այլ արժեք վերադարձնում է 400 bad_request՝ Invalid traffic: forecast, live or off հաղորդագրությամբ։ Առանց պարամետրի հարցումները ստանում են լռելյայն արժեքը՝ forecast։

Բեռնատարների արգելքները կանխատեսվող հասնելու ժամանակին. forecast-ի կամ live-ի դեպքում truck_bans[].active-ը այժմ գնահատվում է այն ժամանակ, երբ բեռնատարը կանխատեսվում է հասնել յուրաքանչյուր արգելքին (depart_at-ից, կամ հիմա, եթե չեք ուղարկել), այդ արգելքի համար որևէ սպասումից առաջ։ Նոր truck_bans[].active_at դաշտը տալիս է գնահատված ժամանակը՝ արգելքի երկրի տեղական ժամանակով։ bans_summary-ն, restriction_hits-ը և legal-ը հետևում են նույն եզրակացություններին, իսկ արգելքը, որին կանխատեսվող ուշացումը նոր է հանգեցնում (օրինակ՝ հաջորդ օրը կամ այլ երկրում), նույնպես նշվում է truck_bans-ում։ traffic=off-ի դեպքում active-ը գնահատվում է ազատ ընթացքի ժամանակագրությամբ, և active_at-ը հավասար է eta_at_ban-ին։

Նոր ապրանք՝ Truck Route API (GET /api/v2/data/truck-route, միայն v2)։ Մեկ հարցումը վերադարձնում է բեռնատարի համար թույլատրելի երթուղի և այն ամենը, ինչ դիսպետչերին անհրաժեշտ է ճանապարհին։ Երթուղին հաշվարկվում է մեր TruckTurn բեռնատարների նավիգացիոն հավելվածի հետ նույն երթուղիավորման միջուկով՝ մեր սեփական քարտեզային տվյալների վրա։

• Փոխադրամիջոց՝ height, width, length, weight, axle_load, axles, trailers, emission_class, hazmat (ADR դասեր) և adr_tunnel (B–E)։ Բեռնատարների երթևեկության արգելքները և սահմանափակման գոտիները ստուգվում են վերադարձված գծի վրա։
• Երթուղու երկայնքով՝ վառելիքի լցակայաններ ընթացիկ գներով, բեռնատարների կայանատեղիներ և կշեռքային կետեր՝ յուրաքանչյուրը km_from_start-ով և շեղման չափով։
• Վարորդի հանգստի պլան EU 561/2006 կանոնակարգով՝ ընդմիջումներ (ներառյալ բաժանված 15+30), օրական և շաբաթական հանգիստ (ներառյալ կրճատվածը), մեկ կամ երկու վարորդից բաղկացած անձնակազմ (crew=2)․ եթե փոխանցեք վարորդի ընթացիկ վիճակը, պլանը սկսվում է դրանից։ Յուրաքանչյուր կանգառ տեղադրվում է երթուղու վրա գտնվող իրական կայանատեղիում։ Սա պլանավորման գործիք է, ոչ թե տախոգրաֆի գրառում։
• ETA՝ հաշվի առնելով հանգիստը, բեռնատարների երթևեկության արգելքները և սահմանին սպասումները։ Պլանավորումը կատարվում է depart_at կամ arrive_at պարամետրով։
• Ճանապարհային վճարների գնահատում ըստ երկրների (EUR, ըստ առանցքների և արտանետման դասի)․ առանց գնի երկրները թվարկվում են tolls.coverage_note-ում։ Նաև avoid (վճարովի ճանապարհներ, լաստանավեր, ավտոմայրուղիներ, սահմաններ, թունելներ, չասֆալտապատ ճանապարհներ, ցածր արտանետումների գոտիներ), մինչև 2 այլընտրանք, բաշխում ըստ երկրների և geometry՝ polyline5, polyline6 կամ GeoJSON ձևաչափով։

Քվոտա՝ truck-route-ի առանձին սահմանաչափ՝ օրական 10 հարցում յուրաքանչյուր հաշվի համար, վճարովի պլաններում ավելի շատ, և Լրացուցիչ truck-route հարցումներ հավելում։ Sandbox-ում կարող եք օրական գործարկել 10 բեռնատարի երթուղի, տեսնել արդյունքը քարտեզի վրա՝ երթուղու ամբողջական պլանով, և արտահանել այն GPX, KML, GeoJSON, CSV, օրացույցի (.ics) կամ ITN ձևաչափով։ Տես ապրանքի էջը և տեղեկատու փաստաթղթերը։

Համաձայն API-ի Պայմանների՝ Market-ը այն երկիրն է, որի տվյալներն օգտագործում եք, և ձեր բանալին ընդգրկում է ձեր հաշվի համար հաստատված երկրները։ Մինչ այժմ կոորդինատների վրա հիմնված ապրանքները (lat/lon — օր.՝ Nearby Shops, Truck Parkings, Fuel Stations) պատասխանում էին Եվրոպայի ցանկացած կետի համար։ 2026 թ. հոկտեմբերի 13-ից, սա ստուգվում է ձեր հարցումը մշակելիս.

• Հարցում, որի lat/lon-ը գտնվում է ձեր հաշվի համար չհաստատված երկրում, վերադարձնում է 403 error.code-ով market_not_allowed։ Հաղորդագրությունը նշում է երկիրը և ձեր հաստատված ցանկը։
• Երբ շառավիղը հատում է սահմանը, արդյունքները, որոնց country_code-ը ձեր հաստատված երկրներից դուրս է, հեռացվում են։ Այդ դեպքում պատասխանը պարունակում է markets_filtered (քանիսն են հեռացվել) և markets_notice, իսկ total_found-ը հաշվում է միայն ստացվածը։

Սա վերաբերում է հաշիվներին, որոնց երկրները վերանայվել են (approved կամ partial կարգավիճակ)։ Հարցումում ոչինչ չի փոխվում՝ ոչ նոր պարամետր, ոչ նոր տարբերակ։ Եթե ձեր հավելվածին անհրաժեշտ է ևս մեկ երկիր, ավելացրեք այն մշակողների պորտալում մինչև հոկտեմբերի 13-ը։ market_not_allowed-ը նշված է մյուս սխալի կոդերի հետ միասին տեղեկատուում։

Nakordoni Partners հաշվին կապված՝ նույն էլ. փոստով, մշակողի հաշիվները այժմ կարող են նորություններ ուղարկել և կառավարել իրենց NakBus նավատորմը (NakDriver / NakManager) partners.nakordoni.eu-ից, թիմային դերերով (Owner, Manager, Viewer) և երկու պորտալների միջև մեկ սեղմումով մուտքով։ Մշակողի պորտալի էջերը, API բանալիները, նավատորմի վերջնակետերը և հավելվածները մնում են անփոփոխ։

Fuel Prices-ում updated_at-ը և պատասխանի սեփական age_hours/stale դրոշը աշխատում էին տարբեր ժամացույցներով․ updated_at-ը փոխվում է միայն երբ գինն իրոք փոխվում է, բայց հնացումը հաշվարկվում էր այնպես, կարծես այն փոխվում է յուրաքանչյուր հաստատման ժամանակ։ Գներով ինդեքսի 46.7%-ը ցույց էր տալիս age_hours ≤48 և stale:false, մինչդեռ updated_at-ը իրականում 48 ժամից ավելի հին էր, իսկ 12,620 լցակայանի տվյալները մեկ շաբաթից ավելի հին էին։ Այժմ յուրաքանչյուր գին նաև ունի confirmed_at՝ այն վերջին պահը, երբ հաստատել ենք գինը, կլորացված մինչև ժամ, երբեք ոչ ավելի վաղ, քան updated_at-ը, և age_hours/stale հաշվարկվում են դրանից։ updated_at-ի իմաստը չի փոխվել․ օգտագործեք այն, երբ ուզում եք իմանալ, թե գինը երբ է վերջին անգամ փոխվել, իսկ confirmed_at-ը՝ երբ ուզում եք իմանալ, թե որքան թարմ է այն հիմա։ Սառեցված v1 պայմանագրում բացակայում է։

Լեզվի երկու սխալ, երկուսն էլ անաղմուկ․ երբ վառելիքի կանոնական կոդը ուղարկվում էր lang=pl-ով (կամ կայքի մյուս 24 լեզուներից որևէ մեկով), fuel_type_local-ը միևնույն է վերադառնում էր անգլերեն — պիտակների աղյուսակում ստուգվում էին ընդամենը 10 լեզու, ուստի այդ ցանկից դուրս ամեն ինչ ընկնում էր ինտերֆեյսի լռելյայն բառապաշարի մեջ՝ ձեր պահանջած լեզվի փոխարեն։ Առանձին, lang=tr-ը (կամ մի քանի այլ վավեր կոդեր) լցակայանների ցանկերը վերադարձնում էր ուկրաիներեն, քանի որ ներքին լռելյայն uk-ն գործարկվում էր, երբ պահանջված լեզուն այդ նույն 10 լեզվի ցանկում չէր։ Երկուսն էլ ուղղված են․ ձեր ուղարկած լեզուն այժմ այն լեզուն է, որ ստանում եք՝ բոլոր 25-ի համար։

Նաև․ Nearby Fuel Stations-ում brand-ը այլևս չի վերադարձնում ներմուծման հումքային նշանը՝ OTHER, մոտ 330 լցակայանների համար, որոնց բրենդը մենք չգիտենք — այն null է՝ ի համապատասխանություն պատասխանի մյուս բոլոր անհայտ դաշտերի։

Border AI Assistant-ը (/api/v1/data/assistant) վերադարձնում էր 503 internal_error — «Assistant temporarily unavailable» — երբ նույն բանալիով նույն հարցը տրվում էր երկու անգամ հինգ րոպեի ընթացքում։ Իրականում ոչինչ անհասանելի չէր. այդ դեպքերի մեծ մասում պատասխանն արդեն հաշվարկված էր և պատրաստ էր վերադարձվելու։ Այժմ այն վերադարձվում է սովորական ձևով՝ ok: true և HTTP 200 արժեքներով։

Երբ կրկնվող հարցումը գալիս է, մինչ առաջին պատասխանը դեռ գրվում է, կանչն այժմ 503-ի փոխարեն վերադարձնում է 429՝ error.code դաշտում duplicate_request արժեքով, որպեսզի կրկնման քաղաքականությունը կարողանա տարբերել «մի պահ անց նորից հարցրեք»-ը իրական խափանումից։ Երկու դեպքերն էլ ձեր հաշվի սխալների ցուցանիշում հաշվվում էին որպես սերվերի սխալ. այլևս չեն հաշվվում։ Հարցման մեջ ոչինչ չի փոխվում՝ ոչ պարամետր, ոչ տարբերակ։ duplicate_request-ը նշված է մյուս սխալի կոդերի հետ տեղեկատու փաստաթղթում։

Truck Parking-ը (/api/v2/data/truck-parkings) վերադարձնում էր գրառումներ, որոնց name-ը null էր, իսկ address-ը՝ դատարկ — Բենսհայմի մոտ՝ 50-ից 20-ը։ Դրանք վայրեր են, որոնք մենք պահում ենք միայն որպես կոորդինատ. ցուցադրելու ոչինչ չկա և ձեր սեփական POI-ների հավաքածուի հետ համադրելու ոչինչ չկա։ Դրանք այլևս այս ծառայության մաս չեն կազմում. այժմ վերադարձվում են միայն անվանում ունեցող վայրեր՝ ներկայումս ավելի քան 22 000 ամբողջ Եվրոպայում։ Եթե դուք ինքներդ եք զտել առանց անվանման գրառումները, այդ կոդն այժմ ավելորդ է, բայց անվնաս։ Նույն radius-ի և limit-ի դեպքում պատասխաններն ավելի կարճ են դառնում, և վերադարձվող յուրաքանչյուր գրառում օգտագործելի է։

Առանձին՝ մոտ 10 000 կայանատեղի name դաշտում պարունակում էր կոորդինատների չմշակված զույգ, օրինակ՝ 51.927301,10.14112, մինչդեռ իրական անվանումը գտնվում էր address-ում։ Այժմ դրանք կրում են այդ անվանումը՝ Ionity, Seesen, Rest Area A5 E35 Kaelberpfad, Bensheim — ամենուր, որտեղ հայտնվում են, ներառյալ /api/v1/data/pois-ը։ Յուրաքանչյուր վայրի id-ն անփոփոխ է, ուստի քեշավորված համապատասխանեցումը մնում է վավեր. փոխվում է միայն name-ը։

snapshot.updated_at դաշտը /api/v1/data/queue և /api/v1/data/multi հարցումներում տեղական ժամանակն է անցակետի սեփական գոտում (օրինակ՝ Europe/Istanbul, Europe/Sofia, Europe/Budapest, Europe/Warsaw, Europe/Kyiv), սակայն մինչ այժմ պատասխանում ոչինչ չէր նշում, թե որ գոտին է դա, ուստի կանչողը չէր կարող այն վերածել կոնկրետ պահի։ snapshot-ը ստանում է լրացուցիչ timezone դաշտ (IANA անվանում)՝ updated_at-ի կողքին։ Ոչ պարամետր, ոչ տարբերակ, ոչ էլ այլ դաշտ չի փոխվում։

Մինչ այժմ վառելիքի յուրաքանչյուր վերջնակետ իր ծածկույթը նկարագրում էր ձեռքով գրված ցանկով՝ AT, DE, DK, ES, FR, HR, IT, LU, PL, PT, SI, իսկ Լեհաստանը դրանում սահմանափակված էր Trójmiasto-ի տարածքով։ Երկու պնդումն էլ վաղուց հնացել էին։ Ծածկույթն այժմ չափվում է կայանների կենդանի ինդեքսից և վերահաշվարկվում է յուրաքանչյուր վեց ժամը մեկ. այսօր 39 երկրում կան գներով կայաններ, նրանց թվում՝ Լեհաստանում ամբողջ երկրով մեկ, և ոչ թե երեք քաղաքում։ Հարցման մեջ ոչինչ չի փոխվում՝ ոչ պարամետր, ոչ տարբերակ։

Nearby Fuel Stations և Cheapest Fuel. երբ որոնումը դատարկ է վերադառնում, coverage բլոկն այժմ պարունակում է չափված station_countries, station_counts, sparse_coverage և measured_at արժեքները՝ սահմանափակված ձեր հարցրած վառելիքի տեսակով, ոչ թե վառելիքով ընդհանրապես։ Երկիրը հայտնվում է sparse_coverage-ում, երբ այնտեղ ունենք գնով 25 կամ ավելի քիչ կայան. սա հաշվարկ է, ոչ թե գնահատական։

Հայտնվել է նոր նշում այն տեսակի համար, որը մենք ճանաչում ենք, բայց որի գինը ոչ ոք չի տալիս այնտեղ, որտեղ հարցրել եք։ Մինչ այժմ coverage.fuel_type_note-ը հայտնվում էր միայն այն դեպքում, երբ բաշխիչի անվանումն ինքնին մեզ անծանոթ էր։ Այժմ այն հայտնվում է նաև այն դեպքում, երբ անվանումը ճիշտ է ճանաչվում, բայց տվյալ երկրում դրա համար պարզապես գին չկա. այն նշում է այն երկրները, որտեղ այդ տեսակը գնով է, և այն տեսակները, որոնց գինը տալիս ենք ձեր շրջակայքում։ Չեխական Natural 100 անվանումը մաքուր օրինակ է՝ այն ճանաչվում է, բայց Չեխիայում ոչ մի աղբյուր դրա գինը չի տալիս։ Դատարկ պատասխանն այլևս չի թվում կոտրված հարցում։

Fuel Grades (/api/v2/data/fuel-grades) ամեն տեսակի համար ստանում է priced_countries և priced_station_counts, ինչպես նաև priced_here, երբ փոխանցում եք ?country=։ Երկու ցանկերը տարբեր բան են նշանակում. countries-ում նշված երկիրն այն երկիրն է, որտեղ մենք ընդունում ենք բաշխիչի այդ անվանումը, իսկ priced_countries-ը ցույց է տալիս, թե որտեղ է աղբյուրն իրականում գին տալիս, ուստի priced_here-ի 0 արժեքը իսկական պատասխան է, ոչ թե բաց պատասխանի մեջ։ Պատասխանը կրում է նաև coverage_measured_at և coverage_note, իսկ Cache-Control-ը 24 ժամից իջնում է 6-ի՝ վերահաշվարկի հաճախականությանը համապատասխան։

Ճանաչվում են նաև ավելի շատ տեղական բաշխիչային անվանումներ, դրանց թվում՝ Klimadiesel 90 (HVO100) և HVO Diesel, Erdgas և Metano, Autogas և Autogaz, DEF՝ AdBlue-ի համար, ինչպես նաև պրեմիում դիզելային վառելիքի և բենզինի մի շարք ապրանքանիշային անվանումներ։ Ճանաչման հերթականությունը մնացել է անփոփոխ, համընկնումը՝ ճշգրիտ, ուստի նախկինում աշխատող ոչ մի անվանում այսօր այլ բան չի նշանակում, իսկ նոր անվանումը կարող է առավելագույնը դատարկ պատասխանը վերածել գներով պատասխանի։ Միաժամանակ տեղեկատու փաստաթղթերը և վերջնակետերի նկարագրությունները ուղղվել են կայքի բոլոր 25 լեզուներով։

Cheapest Fuel-ը (/api/v2/data/fuel-cheapest) վերադարձնում էր ամենամոտ կայանները՝ ըստ հեռավորության հերթականության, փոխանակ ամենաէժանների: Քանի որ դասակարգումը կիրառվում էր մինչև արդյունքի կրճատումը ձեր limit-ի չափով, ձեր շառավղի ամենաէժան կայանները կարող էին ամբողջովին բացակայել պատասխանից: Դասակարգումն այժմ ճիշտ է. նախ՝ ամենաէժանը հայցված վառելիքի տեսակի համար, հավասարության դեպքում հաղթում է ամենամոտ կայանը, իսկ տվյալ տեսակի համար գին չունեցող կայանը դասվում է վերջում: Հարցումում ոչինչ չի փոխվում՝ ո՛չ պարամետր, ո՛չ տարբերակ:

v2 վառելիքի պատասխանները նույնպես փաստագրված են այնպես, ինչպես դրանք իրականում մատուցվում են. կայանները հայտնվում են data.stations[]-ի ներքո՝ մեկ գրառում յուրաքանչյուր ֆիզիկական կայանի համար, յուրաքանչյուր տեսակ ներդրված է prices օբյեկտի մեջ (price, currency, local_name, updated_at, age_hours, stale)՝ ի հավելումն station_ref, grades, total_found և notices: Nearby Fuel Stations-ի և Cheapest Fuel-ի տեղեկատու փաստաթուղթը դեռ նկարագրում էր հները՝ հարթ data.data[] տողերի ցանկը:

Վճարումների էջում (ամսական ներդիր) ցանկացած փաթեթի վրա հասանելի է երկու հավելում՝ առանց փաթեթը փոխելու. Լրացուցիչ կանխատեսման հարցումներ — յուրաքանչյուր բլոկի համար օրական +100 կանխատեսման և վիճակագրության հարցում, բլոկի համար ամսական €2, առավելագույնը 10 բլոկ; և Լրացուցիչ երկրներ — յուրաքանչյուր միավորի համար +1 հայտարարվող երկիր, յուրաքանչյուրը ամսական €2. Քանակը փոխելիս ցուցադրվում է ճշգրիտ համամասնական հաշվարկ՝ նախքան որևէ գումարի գանձումը.

2026 թ. նոյեմբերի 10-ից յուրաքանչյուր փաթեթ ներառում է հայտարարված երկրների որոշակի թիվ. Explorer և Student 4, Starter 10, Pro և ավելի բարձր՝ անսահմանափակ. Այդ ամսաթվից հնարավոր չի լինի պահպանել հայտարարագիր, որը գերազանցում է փաթեթը գումարած ձեռք բերված լրացուցիչ երկրները; «Հաշիվ» ներդիրն արդեն ցույց է տալիս ձեր սահմանաչափը, իսկ այն արդեն գերազանցող հաշիվները վահանակում տեսնում են առաջարկ. Մինչև նոյեմբերի 10-ը ոչինչ չի փոխվում.

API sandbox-ն այժմ ցանկում յուրաքանչյուր վերջնակետ նշում է իր քվոտայի դասով (Ծանր / Ստանդարտ), ցույց է տալիս ընտրված տարբերակի քվոտայի արժեքը նախքան որևէ բան գործարկելը, իսկ հարցումից հետո ցույց է տալիս, թե նույն հարցումը որքան կարժենար ձեր իրական քվոտայից — ներառյալ ceil(N ppids × M sub-products / 2) բանաձևը, որն օգտագործվում է /multi տիպի հարցումների համար.

Սա միայն ընթերցման նախադիտում է. sandbox-ի հարցումներն իրենք հանվում են sandbox-ի առանձին փորձնական բյուջեից, երբեք ձեր իրական քվոտայից.

Այսօրվանից այն ամենը, ինչի դադարեցումը մենք հրապարակավ հայտարարել ենք, փակ է հայտարարության ամսաթվին կամ դրանից հետո ստեղծված մշակողի հաշիվների համար։ Եթե ձեր հաշիվը գոյություն է ունեցել հայտարարությունից առաջ, ոչինչ չի փոխվում — դուք պահպանում եք ամբողջ արտոնյալ ժամկետը՝ ընդհուպ մինչև այն դադարեցման ամսաթիվը, որը նշված է դա հայտարարող գրառման մեջ։

Ինչու է անհրաժեշտ այս կանոնը։ 2026 թ. օգոստոսի 24-ին մենք հայտարարեցինք, որ truck-bans v1-ը դադարեցվում է 2026 թ. սեպտեմբերի 8-ին։ Այդ հայտարարությունից օրեր անց գրանցվեց երկու հաշիվ, իր ինտեգրումը կառուցեց v1-ի վրա և ընդամենը ժամերի հեռավորության վրա հայտնվեց 410-ից՝ առանց մեր որևէ նամակ ստանալու. և՛ հայտարարությունը, և՛ ծանուցումների առաքումը նախորդել էին նրանց գրանցմանը։ API-ում ոչինչ չխանգարեց նրանց որդեգրել այն տարբերակը, որի հեռացման մասին մենք արդեն ասել էինք։ Դա մեր վրիպումն էր, և սա դրա ուղղումն է — չեք կարող նոր սկսել օգտագործել այն, ինչի հեռացումն արդեն նախատեսված է։

Ինչպիսի տեսք ունի դա։ Նման հարցումը մերժվում է 410 Gone պատասխանով և version_closed_to_new_accounts սխալի կոդով։ Հաղորդագրության մեջ նշվում են դադարեցման ամսաթիվը, հայտարարության ամսաթիվը և այն տարբերակը, որը պետք է օգտագործել դրա փոխարեն։ Դա միտումնավոր տարբերվում է version_sunset կոդից, որը ստանում է յուրաքանչյուր հաշիվ այն բանից հետո, երբ դադարեցման ամսաթիվն ինքն արդեն անցել է — աջակցման ծառայությունը կարող է առանց մատյան կարդալու տարբերել «դուք շատ ուշ եկաք սկսելու համար»-ը «սա հեռացված է բոլորի համար»-ից։

Արտոնությունը որոշվում է հաշվի ստեղծման ամսաթվով, ոչ թե առաջին հարցումով։ Եթե դուք գրանցվել եք հայտարարությունից առաջ, բայց ինտեգրումը սկսում եք միայն հիմա, միևնույն է՝ ստանում եք ամբողջ արտոնյալ ժամկետը. հնարավոր է՝ դուք ամբողջ ընթացքում կառուցել եք դրա հիման վրա։

Այժմ ուժի մեջ է truck-bans v1-ի համար (հայտարարվել է 2026 թ. օգոստոսի 24-ին, դադարեցվում է 2026 թ. սեպտեմբերի 8-ին) և ավտոմատ կերպով՝ այսուհետ մեր հայտարարած յուրաքանչյուր դադարեցման համար։ Ձեզնից նոր ոչինչ չի պահանջվում. դադարեցվող տարբերակի յուրաքանչյուր պատասխան արդեն պարունակում է Deprecation, Sunset և Link: rel="successor-version" վերնագրերը, այնպես որ նոր ինտեգրումը կարող է տեսնել մոտեցող դադարեցումը՝ առանց այս էջը կարդալու։

Երեկվա v4 փոփոխության շարունակությունը (մշակողների հայտ #105). v1-ում և v2-ում ստորակետերով բաժանված destination ցանկերը շարունակում են աշխատել, սակայն այժմ ենթարկվում են նույն ժամկետին, ինչ destination=all-ը. երկուսն էլ դադարում են 2026-10-06-ին (մինչ այդ՝ Deprecation/Sunset վերնագրեր, դրանից հետո՝ 400 destination_list_removed, որը որպես փոխարինող նշում է /api/v4/-ը). Ստորակետերով ցանկերի 10 տարրի գործող սահմանաչափի ստուգումն այդ ամսաթվից առաջ չի փոխվում.

v4-ը մնում է մեկ ուղղություն մեկ հարցման դեպքում — այսօր դա չի փոխվել. Փոխվել է միայն այն, թե ինչպես են ներկայացվում v1/v2-ը. destination=all-ի 400 սխալն այլևս չի առաջարկում ստորակետերով ցանկը որպես միգրացիայի ուղի (այն կդադարեր նույն ամսաթվին), այլ ուղղակիորեն ցույց է տալիս v4-ը.

Փաստաթղթի ուղղում. այս կայքում v4-ի օրինակը նախկինում այսպիսին էր՝ /api/v4/data/border/1/2,3,4/9 — ստորակետերով ցանկ, որը v4-ը մերժում է. Այժմ այն է՝ /api/v4/data/border/1/2/9. Ով պատճենել էր հին օրինակը, առաջին իսկ հարցման ժամանակ կստանար 400. ներողություն ենք խնդրում.

Նոր թարգմանված բանալի product_border_v4_p_destination-ը հրապարակվում է կայքի բոլոր 25 լեզուներով և հստակ ձևակերպում է v4-ի մեկ ուղղության կանոնը՝ v1/v2-ի ձևակերպմանը վերադառնալու փոխարեն.

/api/v4/data/border/{origin}/{destination}/{crossing_type}-ը գործում է այսօրվանից։ v2-ի համեմատ փոխվում է երեք բան, և հենց դրանք միասին են պատճառը, որ սա նոր տարբերակ է, ոչ թե խմբագրում։

1. Այլևս ոչ մի destination=all։ Մեր տվյալները լիցենզավորված են ըստ երկրի (Developer API-ի պայմաններ, բաժին 7), իսկ «բոլոր հարևանները, որոնց տվյալները մենք ունենք» ձևով ընդլայնվող ընդհանրացնող նշանը վերադարձնում է երկրներ, որոնց համար ձեր հաշիվը կարող է հաստատված չլինել, և հարցման մեջ ոչինչ դա ցույց չի տալիս։ v4-ում երկիրը նշում եք դուք։

2. Մեկ հարցման համար մեկ նպատակակետ երկիր։ /api/v4/data/border/1/2/9-ը հարցնում է մեկ սահման։ Ստորակետով ցանկերը չեն ընդունվում. ուղարկեք 1/2/9, 1/3/9 և 1/4/9 որպես առանձին հարցումներ։ Ստորակետով ցանկը կամ all-ը պատասխանում է 400 և նշում է հենց այն հարցումները, որոնք պետք է ուղարկել, այնպես որ ոչինչ լուռ չի ձախողվում։

3. Բեռնատարների համար մեկ կոդ։ v1-ը և v2-ը բեռնափոխադրումները բաժանում էին 8-ի (Բեռնափոխադրում) և 9-ի (Բեռնափոխադրում մինչև 7.5 տ)։ Այդ բաժանումն իրական է անցակետում, բայց ոչ մի ինտեգրատոր չի կարող դրա հիման վրա գործել. v2-ից UA-PL սահմանի համար 9 հարցնելը վերադարձնում էր բեռնատարների 70 անցակետից 21-ը, և ոչինչ դա չէր հայտնում։ v4-ը 9-ին պատասխանում է բեռնատարների բոլոր գծերով և ընդունում է 8-ը որպես 9-ի հոմանիշ։ Յուրաքանչյուր տող կրում է իր սեփական crossing_type-ը, այնպես որ միավորված պատասխանը մնում է ստուգելի։

v1-ում և v2-ում destination=all-ը շարունակում է աշխատել մինչև 2026-10-06 և մինչ այդ կրում է Deprecation / Sunset վերնագրերը։ Այդ ամսաթվից այդ տարբերակները all-ին նույնպես պատասխանում են 400, իսկ v1-ի և v2-ի մնացած մասը մնում է անփոփոխ ու հասանելի։ Նույն ամսաթիվը վերաբերում է բոլոր երկրները ընդգրկող մյուս կրճատ ձևերին. travel-matrix՝ առանց ?dest=, bus-carriers՝ ?ppid=all-ով, և fuel-grades՝ առանց ?country=։

Այսօր ավելի վաղ հայտարարված v3-ը փոխարինվում է v4-ով։ v3-ը v4-ից տարբերվում էր միայն նրանով, որ դեռ ընդունում էր ստորակետով ցանկը, և ոչ մի ինտեգրում այդ ձևը չի օգտագործում։ v3-ի URL-ները շարունակում են պատասխանել, այնպես որ դրանց հիման վրա գրվածը չի կոտրվի, բայց v3-ը փաստաթղթավորված չէ և այլևս չի զարգացվելու. անցեք v4-ին։

v4-ի մնացած ամեն ինչ նույնն է, ինչ v2-ում՝ ուղու ուղղության հերթականությունը, direction{from,to}, stale և ?max_age_min=։

/border/{origin}/{destination}/{crossing_type}-ի թվային նույնացուցիչները երբեք աղյուսակի տեսքով չեն հրապարակվել, ուստի ինտեգրատորները դրանք վերականգնում էին ժամային գոտիներից և օրինակելի URL-ներից։ Այժմ դրանք փաստաթղթերում են՝ Երկրների և տրանսպորտի տեսակի կոդեր բաժնում, ստեղծված նույն աղյուսակներից, որոնցով ստուգում է API-ն. երկրների նույնացուցիչները՝ իրենց ընդգրկած սահմաններով, և յուրաքանչյուր crossing_type՝ API-ի վերադարձրած պիտակով։

Դրանք հրապարակելիս պարզեցինք, որ sandbox-ը և վերջնակետի մետատվյալները 8-ը նկարագրում են որպես «truck<7.5t», իսկ 9-ը՝ որպես «truck»։ Դա շրջված է. API-ն 8-ը պիտակավորում է Բեռնափոխադրում, իսկ 9-ը՝ Բեռնափոխադրում մինչև 7.5 տոննա, և միշտ այդպես է եղել։ Եթե բեռնատարի կոդն ընտրել եք պարամետրի հուշումից, ապա զտել եք հակառակ գիծը՝ ձեր նկատի ունեցածի փոխարեն։ Ուղղվել է ամենուր, իսկ v3-ը այդ ընտրությունը վերացնում է ամբողջությամբ։

API-ի պայմաններ v1.1-ը փոխարինում է v1.0-ին՝ մինչև դրա ուժի մեջ մտնելը, և գործում է 2026-10-06-ից։ Խնդրում ենք ընդունել դրանք ձեր վահանակում։

Բաժին 7-ն այժմ ասում է, թե ինչ է Շուկան. այն երկիրը, որի տվյալներն օգտագործում եք, այսինքն՝ որտեղ գտնվում է ձեր հարցրած անցակետը կամ սահմանը, և ոչ թե այն երկիրը, որտեղ ապրում են ձեր օգտատերերը։ Մեր վահանակը տարբեր տեղերում ասել է երկու բանն էլ. կիրառումը միշտ նկատի է ունեցել առաջինը։

Ձեր օգտին երկու փոփոխություն։ Ձեր հաշվի համար արդեն հաստատված երկրները մնում են օգտագործելի, քանի դեռ հետագա փոփոխությունը քննարկման փուլում է (նոր երկիր ավելացնելն այլևս չի կասեցնում արդեն ունեցածները)։ Իսկ եթե մենք 5 աշխատանքային օրվա ընթացքում չենք պատասխանել շուկայի հայտարարագրին, ձեր սակագնի ամբողջ սահմանաչափերը գործում են, մինչև որ պատասխանենք։

Բաժին 10.3-ն այժմ համապատասխանում է նրան, ինչ իրականում պահանջում է վահանակը, իսկ բաժին 13.2-ը սահմանում է հասանելիության հիմք, որը մենք չափում ենք և կարող ենք ցույց տալ ձեզ։

Երեք արտադրանք այժմ կրում է լրացուցիչ data_quality դաշտը (high կամ low), որը նշում է՝ չափումն իրական դիտարկո՞ւմ է, թե՞ մոդելային գնահատական՝ առանց տվյալ անցակետում կենդանի հաշվարկի աղբյուրի. queue (վերին մակարդակի snapshot-ում և data[]-ի յուրաքանչյուր պատմական տողում, բացակայում է կանխատեսման տողերում), update-info (ծրարում) և multi (յուրաքանչյուր անցակետի համար ինչպես queue, այնպես էլ update_info ենթաօբյեկտներում)։ Սա նոր ազդանշան չէ, հիմքում ընկած դրոշակն արդեն գոյություն ուներ ներքին մակարդակում, բայց այն երբեք չէր բացահայտվում, ուստի ամբողջովին մոդելավորված անցակետը նույնական էր թվում ուղղակի չափվածին։ is_realtime-ը միտումնավոր անփոփոխ է. այն մոդելավորված տողերի համար դեռ ցույց է տալիս true, իսկ այդ իմաստը փոխելը v2 մակարդակի կոտրող փոփոխություն է, որը մենք այստեղ չենք անում։

Նաև այս թողարկումից՝ queue-advanced արտադրանքն այլևս չի վերաբաշխում աղբյուրի չմշակված եղանակային տվյալները։ weather_main, temperature և wind_speed դաշտերը փոխարինվում են ածանցյալ condition_code-ով (0–5 վտանգի սանդղակ, null՝ երբ եղանակի տվյալ չկա), condition և severity դաշտերով։

2026-08-30-ից մեկ /api/v1/data/multi հարցում սպասարկվում է առավելագույնը 5 անցակետի համար։ Ավելի շատ PPID թվարկող կանչը չի մերժվում․ այն դարձյալ վերադարձնում է 200, սակայն պատասխան են ստանում միայն ?ppids=-ում նշված առաջին 5 ID-ները։ Մնացած ID-ներն անտեսվում են, վերադարձվում են meta.ppid_cap.ignored-ում և չեն հաշվառվում ձեր քվոտայից — կանչը վճարվում է ըստ այն բանի, ինչ իրականում վերադարձնում է։

Քանի դեռ կանչը գերազանցում է սահմանաչափը, պատասխանը պարունակում է X-Devapi-Warning: multi_ppid_cap վերնագիրը և meta.ppid_cap բլոկը՝ cap, enforced_from, enforced, ppids_asked, ppids_answered և ignored[] դաշտերով։ Մինչև 2026-08-30 այդ դաշտերը հայտնվում են enforced: false արժեքով և արդյունքների ամբողջական հավաքածուով, այնպես որ մոտեցող փոփոխությունը կտեսնեք ձեր իսկ լոգերում։

Քվոտայի կիսով չափ զեղչը մնում է անփոփոխ։ Բաժանեք ձեր անցակետերը 5-ական խմբերի և ձեր սովորական թարմացման ցիկլում ուղարկեք մեկ կանչ յուրաքանչյուր խմբի համար․ եթե հաճախ ստուգում եք միայն հերթի երկարությունը և տվյալների թարմությունը, update-info-ը մնում է ստանդարտ դասի ավելի էժան արտադրանքը։

Ուկրաինայի համար հաշվարկվող շոգի արգելքը՝ վերադարձվում է include_ua_heat-ով, իսկ country=UA-ի դեպքում՝ ավտոմատ, այժմ պատասխանում է ձեր հարցրած ամսաթվերի միջակայքի համար։ Նախկինում այն վերադարձնում էր առաջիկա յոթ օրը՝ անկախ date_from և date_to արժեքներից, ուստի դեկտեմբերյան միջակայքի դեպքում լուռ վերադարձվում էին այս շաբաթվա տողերը։ Արգելքը հաշվարկվում է եղանակի կանխատեսումից, այլ ոչ թե կարդացվում արգելքների օրացույցից, ուստի ունի երկու սահման, որ օրացույցը չունի՝ այն հետ չի նայում և ավարտվում է այնտեղ, որտեղ ավարտվում է կանխատեսումը։ Ձեր միջակայքն այժմ հատվում է այն ամենի հետ, ինչ կանխատեսումն իրականում ծածկում է, իսկ նոր ua_heat_ban.forecast_horizon դաշտը նշում է վերջին հասանելի ամսաթիվը։ Այդ հորիզոնից այն կողմ միջակայքը տող չի վերադարձնում և պատճառը բացատրում է summary-ում — դա նույնը չէ, ինչ «արգելք չկա»։ v1 պատասխանները մնում են անփոփոխ։

Պատասխանի կառուցվածքն այս պահի դրությամբ ոչ մի տեղ նկարագրված չէր. միակ ձևը իմանալու, թե ինչ է վերադարձնում ծառայությունը, դրա կանչն էր։ Այժմ յուրաքանչյուր ծառայության էջում, պարամետրերի աղյուսակի տակ, կա աղյուսակ՝ Պատասխանի դաշտերը յուրաքանչյուր դաշտի կարճ նկարագրությամբ. ցուցակի տարրերի դաշտերը ցուցադրվում են այսպես՝ items[].name, իսկ ծրարի մակարդակի դաշտերը (usage, meta, snapshot, resolved_location)՝ առանց նախածանցի։ Նկարագրված է 42-ից 40 ծառայություն. դեռ չգործարկված երկուսը՝ (weather, road-quality) գիտակցաբար մնում են առանց նկարագրության։ Նույն աղյուսակը հրապարակվում է նաև GitHub-ի մեր բաց փաստաթղթային հայելում։

Այժմ վառելիքի յուրաքանչյուր ծառայություն ընդունում է վառելիքի տեղական անվանումը, ոչ միայն մեր ներքին գրելաձևը՝ ON Լեհաստանում, Nafta Չեխիայում, Gázolaj Հունգարիայում, Motorină Ռումինիայում, ДП Ուկրաինայում, Motorin Թուրքիայում, Gasóleo Պորտուգալիայում և Իսպանիայում. Անվանումը մեկնաբանվում է առաջին հերթին ըստ երկրի՝ «95»-ը դանիական լցակայանում E10 է, լեհականում՝ E5, ուստի ուղարկեք country պարամետրը տեղական անվանման հետ միասին կամ կոորդինատներ, որոնցով կարող ենք տեղորոշել կետը։ Պատասխանում վերադարձվում են fuel_type (կանոնական), fuel_type_requested (ինչպես գրել եք) և fuel_type_local։ Անվանումը, որը չենք կարողանում տեղորոշել, երբեք չենք փոխարինում լռելյայն վառելիքով՝ պատասխանը գալիս է դատարկ և ուղղակի ասում է դա։

Ամբողջ աղյուսակն այժմ առանձին ծառայություն է՝ GET /api/v2/data/fuel-grades[?country=PL][&fuel_type=ON]՝ մեր կանոնական վառելիքները և դրանց տեղական անվանումները Եվրոպայի 41 երկրում, ներառյալ շուկաներ, որոնց համար գին չենք հրապարակում։ Բացի այդ, fuel և fuel-local ծառայությունների երկրի և տարածաշրջանի մակարդակները ստացան grades օբյեկտը, որը գնի յուրաքանչյուր բանալի կապում է վառելիքի և լցակայանում դրա անվանման հետ։

Այժմ truck-bans արտադրանքը պատասխանում է կոնկրետ ամսաթվի կամ ամսաթվերի միջակայքի համար հետևյալ հասցեում՝ /api/v2/data/truck-bans: Մինչ այժմ այն միշտ վերադարձնում էր առաջիկա 7 օրը և անտեսում ուղարկված ամսաթիվը, ուստի օրացույց կազմելու համար պահանջվում էր օրական մեկ հարցում, իսկ վայրկյանում երկու հարցում թույլատրող սակագնում դրանց մեծ մասը մերժվում է հետևյալ սխալով՝ 429 qps_exceeded:

Օգտագործեք ?date=YYYY-MM-DD մեկ օրվա համար կամ ?date_from= և ?date_to= միջակայքի համար: Երկու սահմաններն էլ ներառված են, և ցանկացածը կարելի է բաց թողնել՝ սկիզբը լռելյայն այսօրվա օրն է, վերջը՝ սկիզբը գումարած 7 օր: Պատուհանը կարող է ընդգրկել առավելագույնը 92 օր, ավելի երկարը լռելյայն չի կրճատվում, այլ մերժվում է հետևյալ սխալով՝ 400 date_range_too_long: Սա առաջ նայող օրացույց է. պատուհանը կարող է սկսվել առավելագույնը 7 օր առաջ, իսկ ավելի հին ամսաթվերը մերժվում են և չեն սպասարկվում. ընդգրկումը տարածվում է առաջ մինչև 2028 թվականի դեկտեմբերի 31-ը՝ 23 երկրում:

Յուրաքանչյուր պատասխան այժմ պարունակում է window օբյեկտը, որը նշում է ճշգրիտ ընդգրկված միջակայքը: Սա լրացուցիչ դաշտ է և ուղարկվում է նաև v1-ում, որտեղ v1-ը անփոփոխ պահում է իր ֆիքսված 7-օրյա պատուհանը: Ուշադրություն՝ include_ua_heat միշտ ընդգրկում է առաջիկա 7 օրը՝ անկախ պահանջված պատուհանից, քանի որ այն հաշվարկվում է եղանակի կանխատեսումից, ոչ թե արգելքների օրացույցից: Հիշեցնում ենք, որ այս արտադրանքի v1 տարբերակը դադարեցվում է 2026 թվականի սեպտեմբերի 8-ին:

Երկու առնչվող բարելավում ամբողջ API-ում. ցանկացած պարամետր, որը արտադրանքը չի ընդունում, այժմ նշված է պատասխանի ignored_params դաշտում և այլևս լռելյայն չի անտեսվում, իսկ տվյալների ծառայության վավերացման սխալները ձեզ են հասնում ճիշտ այնպես, ինչպես գրված են՝ մեքենայաընթեռնելի կոդով error.reason դաշտում:

Դարպասի աուդիտից բխող պատասխանների որակի երեք ուղղում (հայտ #43)։

X-API-Key վերնագիրն այժմ ընդունվում է՝ Authorization: Bearer-ի և ?key=-ի կողքին։ Եթե ձեր HTTP հաճախորդը բանալիներն ուղարկում է X-API-Key անունով վերնագրով, դա այժմ աշխատում է — նախկինում այն լուռ անտեսվում էր, և կանչը մերժվում էր որպես missing_api_key։ Authorization: Bearer-ը մնում է փաստաթղթավորված և խորհուրդ տրվող ձևը։

Բացակայող բանալու սխալի հաղորդագրությունն այժմ նշում է նույնականացման բոլոր երեք եղանակները (Bearer վերնագիր, X-API-Key վերնագիր կամ ?key=)՝ միայն գրանցման էջին հղում տալու փոխարեն։

checkpoints ցանկն այժմ ամեն տողում պարունակում է has_day_stats — լրացուցիչ բուլյան դաշտ, որը ցույց է տալիս՝ արդյոք Best Time to Cross (day-stats) API-ն տվյալներ ունի տվյալ անցակետի համար։ Day-stats-ը գոյություն ունի միայն մշտադիտարկվող անցակետերի մի մասի համար. ստուգեք այս դրոշակը հարցում ուղարկելուց առաջ՝ կանխատեսելի 404-ներից խուսափելու համար։ Առկա դաշտերը չեն փոխվել։

Փաստաթղթերում ուղղվել է նաև հետևյալը՝ road-conditions արտադրանքը միշտ հաշվի է առել lang պարամետրը պիտակների տեղայնացման համար — այն պարզապես նշված չէր։

Երկու ուղղում և մեկ նոր տարբերակ truck-bans արտադրանքի համար։

Ստորակետով բաժանված երկրներն այժմ աշխատում են։ ?country=-ն ընդունում է մինչև 3 ISO-2 կոդից բաղկացած ցանկ, օրինակ՝ ?country=DE,RO։ Ավելի երկար ցանկը մերժվում է 400 too_many_countries-ով, այլ ոչ թե լուռ կրճատվում — սա ըստ երկրների արգելքների օրացույց է, ոչ թե զանգվածային տվյալների հոսք։ Նախկինում սա չէր աշխատում. բաժանիչը հեռացվում էր, ուստի DE,RO-ն ընթերցվում էր որպես մեկ DERO նշույթ, ոչ մի բանի հետ չէր համընկնում և վերադարձնում էր success: true՝ total_bans: 0-ով — վստահ «արգելք չկա» երկու երկրի համար, որոնք միասին ունեին 22-ը։ Եթե դա շրջանցել եք՝ ամեն երկրի համար առանձին հարցում ուղարկելով, այժմ մեկ հարցումը ծածկում է բոլորը և արժենում է մեկ կանչ՝ մի քանիսի փոխարեն։

Պատասխաններն այժմ հայտնում են իրենց ամբողջականությունը։ Երեք լրացուցիչ դաշտ՝ returned, total_available և truncated, ցույց են տալիս՝ արդյոք պատասխանը սահմանափակվել է։ Մասնավորապես՝ առանց շրջանակի կանչը վերադարձնում է կրճատված հատված, և մինչ այժմ պատասխանում ոչինչ այդ մասին չէր ասում։ total_bans-ը պահպանում է իր առկա իմաստը (այս պատասխանի տողերը), ուստի ձեր արդեն վերլուծվողից ոչինչ չի փոխվում։

v2-ը շրջանակված է ըստ երկրի։ /api/v2/data/truck-bans-ում ?country=-ն պարտադիր է, և առանց շրջանակի հարցումը մերժվում է 400 scope_required-ով — այս արտադրանքը ըստ երկրների արգելքների օրացույց է, ոչ թե զանգվածային տվյալների հոսք։ v1-ն այսօր չի փոխվել — այն դեռ ընդունում է առանց շրջանակի կանչը և դեռ վերադարձնում է նույն սահմանափակված 50 տողը, ինչ միշտ, ուստի ձեր աշխատող ոչինչ հիմա չի կոտրվում։ Այս արտադրանքի v1-ը դադարեցվում է 2026 թ. սեպտեմբերի 8-ին։ Այն սովորականի պես սպասարկում է մինչև սեպտեմբերի 7-ը. սեպտեմբերի 8-ից v1 հարցումը մերժվում է 410 Gone-ով և v2-ին ուղղորդող հաղորդագրությամբ։ Մինչ այդ ամեն v1 պատասխան կրում է Deprecation: true, այդ ամսաթվով Sunset վերնագիր և հաջորդող տարբերակը նշող Link վերնագիր, այնպես որ հաճախորդի գրադարանը կարող է ցույց տալ վերջնաժամկետը՝ առանց որևէ մեկի կողմից այս էջը կարդալու։ Միգրացիայի համար՝ փոխեք տարբերակի հատվածը /api/v2/data/truck-bans-ի և փոխանցեք ?country=։

Փաստաթղթերի մեկ ուղղում՝ date պարամետրը հեռացվել է։ Այն երկար ժամանակ նշված էր, բայց ծառայությունը երբեք չէր կարդում այն, ուստի այն ուղարկող ցանկացած հարցում լուռ ստանում էր լռելյայն 7-օրյա պատուհանը՝ իր խնդրած օրվա փոխարեն։ Օրն ընտրելու համար զտեք upcoming_bans զանգվածն ըստ նրա date դաշտի։ Նաև DEU-ի նման ISO-3 կոդն այլևս ամփոփման մեջ չի վերածվում երկրի անվան, որտեղ այն առաջացնում էր մոլորեցնող «No truck ban data for: Germany.»-ը։

truck-bans ապրանքն այժմ վերադարձնում է երկրի ողջ տարածքում գործող երթևեկության սահմանափակումները ևս հինգ երկրի համար՝ Բելգիա (BE), Բելառուս (BY), Չեռնոգորիա (ME), Հյուսիսային Մակեդոնիա (MK) և Շվեդիա (SE): Բուլղարիայի, Հունաստանի և Պորտուգալիայի առկա ընդգրկումն ընդլայնվել և թարմացվել է. հունական սահմանափակումներն այժմ հասնում են մինչև 2027 թվականի սեպտեմբեր, իսկ Պորտուգալիան կրկին լցված է տվյալներով:

Պատասխանի կառուցվածքը չի փոխվել: Նոր տողերը կրում են նույն բանալիները, ինչ ցանկացած այլ արգելք՝ date, time_from, time_until, restriction_type, restriction_details, min_weight_tons և details_url: Երբ սահմանափակումը գործում է միայն որոշակի պայմանով, օրինակ՝ բելառուսական ամառային արգելքները գործում են 25 °C-ից բարձր ջերմաստիճանում, այդ պայմանը նշված է restriction_details դաշտում, ուստի կարդացեք այդ դաշտը՝ նախքան վարորդին զգուշացնելը: min_weight_tons-ը null է, երբ կանոնը վերաբերում է փոխադրման դասին (վտանգավոր բեռներ), այլ ոչ թե բեռնատարողությանը:

fuel-stations և fuel-cheapest ապրանքներն այժմ վերադարձնում են կայանային մակարդակի գներ Լեհաստանում: Ընդգրկումը մասնակի է՝ Եռաքաղաքի տարածաշրջանը (Գդանսկ, Գդինյա, Սոպոտ), ուստի Լեհաստանը նշվում է նոր, լրացուցիչ coverage.sparse_coverage զանգվածում՝ առկա coverage.station_countries ցանկի կողքին: sparse_coverage-ում նշված երկիրն ունի կայանների տվյալներ միայն իր տարածքի մի մասի համար. այդ երկրի այլ վայրից կատարված հարցումը վերադարձնում է դատարկ ցանկ՝ ընդգրկման ծանոթագրության հետ միասին, ինչպես նախկինում: Լեհական գները տրվում են PLN-ով:

Զանգվածային հարցման սխալի հաղորդագրությունն էլ ավելի հասկանալի է. երբ lat-ը բացակայում է, scope_required հաղորդագրությունն այժմ ուղղորդում է fuel ապրանքին (?country=XX)՝ երկրի միջին գների համար:

GET /api/v2/data/fuel-local?lat=&lon=-ն այժմ գինը որոշում է երկուսի փոխարեն երեք մակարդակով՝ station, ապա region, ապա country։ Նոր միջանկյալ մակարդակը ստեղծված է Ուկրաինայի համար, որտեղ առանձին լցակայանների գներ ոչ մի տեղ չկան. Ուկրաինայում գտնվող կետն այժմ ստանում է իր մարզի միջին գինը երկրի միջինի փոխարեն և վերադառնում է երկրի միջինին միայն այն դեպքում, երբ մարզի համար գնանշում չկա։

region մակարդակի պատասխանը պարունակում է մարզի կոդը (ISO 3166-2 արժեք, օրինակ UA-46), region_name և region_center_dist_km դաշտերը, ինչպես նաև նույն գնային բանալիները, ինչ երկրի մակարդակը։ Շարունակեք ճյուղավորել կոդը resolution-ի հիման վրա, ոչ թե պատասխանի ձևի։ station և country պատասխանները մնում են անփոփոխ։

Նոր GET /api/v2/data/fuel-local?lat=&lon= վերջնակետը վերադարձնում է լավագույն հասանելի վառելիքի գինը Եվրոպայի ցանկացած կետի համար։ Այնտեղ, որտեղ ունենք առանձին լցակայանների տվյալներ, այն պատասխանում է մոտակա լցակայանների գներով, հակառակ դեպքում՝ այն երկրի միջին գնով, որտեղ գտնվում է կետը, ներառյալ Ուկրաինան, որտեղ առանձին լցակայանների գներ ոչ մի տեղ չկան։

Յուրաքանչյուր պատասխան պարունակում է resolution դաշտը, որը նշում է պատասխանած մակարդակը՝ station (լցակայանների ցանկ distance_km դաշտով, յուրաքանչյուրն իր արժույթով) կամ country (մեկ օբյեկտ երկրի միջին գներով)։ Ճյուղավորեք կոդը resolution-ի հիման վրա, ոչ թե պատասխանի ձևի։ Հասանելի է /api/v2/-ից սկսած՝ fuel, fuel-stations և fuel-cheapest մնում են անփոփոխ։

fuel-stations և fuel-cheapest արտադրանքներն այժմ ընդգրկում են Գերմանիայի զգալիորեն ավելի շատ լցակայաններ, իսկ գները թարմացվում են օրվա ընթացքում՝ ներառյալ գյուղական վայրերը։ fuel_type պարամետրն ընդունում է վառելիքի 13 տեսակ՝ diesel, e5, e10, superplus, super100, premdiesel, truckdiesel, hvo, lpg, cng, adblue, e85 և lng։ Երբ հարցմանը ոչ մի լցակայան չի համապատասխանում, պատասխանում ավելանում է coverage օբյեկտը՝ այն երկրների ցանկով, որոնց համար կան լցակայանների տվյալներ։

radius= պարամետրն այժմ ընդունվում է որպես radius_km-ի համատեղելի այլանուն բոլոր այն արտադրանքներում, որտեղ այն փաստաթղթավորված է։ fuel-stations և fuel-cheapest արտադրանքները, երբ ոչ մի լցակայան չի համապատասխանում, լուռ դատարկ արդյունքի փոխարեն վերադարձնում են լրացուցիչ coverage օբյեկտ՝ լցակայաններ ունեցող երկրների ցանկով և նշումով։ route-plan-ի սահմանային օբյեկտներն այժմ պարունակում են լրացուցիչ wait_basis բանալին՝ car_lane կամ vehicle_lane, որպեսզի հաճախորդները տեսնեն, երբ բեռնատարների սպասման տվյալները վերցված են մարդատար ավտոմեքենաների գոտուց։ Երթուղու երկայնքով բեռնատարների անցակետերի համապատասխանեցումը զգալիորեն ավելի ճշգրիտ է՝ մարդատար գոտու պահեստային տվյալներ այն զույգերի համար, որտեղ բեռնատարների գոտու տվյալներ չկան, սխալ ուղղությունից պաշտպանություն, ավելի խիստ հեռավորության շեմ և միևնույն կետում գտնվող անցումների կրկնօրինակների հեռացում։ Բոլոր փոփոխությունները լրացուցիչ են և չեն խախտում համատեղելիությունը։

Ծրագրավորողների գլխավոր էջն այժմ ունի խարսխված բաժիններ (#products, #plans, #quickstart, #integrations, #datasets, #apps, #companies, #showcase) թռիչքային նավիգացիայով, և յուրաքանչյուր ապրանքի քարտ հղում է իր սեփական փաստաթղթերի էջին։ Նոր Mobile apps բաժինը ներկայացնում է Kordon Online-ը և Truck Bans-ը՝ Google Play հղումներով։ Թարգմանության լրացում. հաշվարկների պատմությունը, մուտքի սխալները, sandbox հղումները և պլան ընտրելու կոճակն այժմ տեղայնացված են բոլոր 25 լեզուներով։

Fleet beacon-ի պատասխանն (POST /api/v1/fleet_position.php) այժմ ներառում է messages զանգված, որը փոխանցում է սեփականատեր→վարորդ սպասող հաղորդագրությունները։ Նոր, միայն սեփականատերերի համար նախատեսված live JSON հոսք (?ajax=live) և "Հաղորդագրություններ վարորդներին" քարտ ֆլոտի վահանակում։ Վարորդի հրավերի նոր էջ՝ /{lang}/get-nakbus (25 լեզու)։

Տեղայնացվել են product_fleet_vehicles/live/history-ի title, desc-ը և fleet-history պարամետրերը՝ ծրագրավորողների պորտալի բոլոր 25 լեզուներով։

/api/v1/data/truck-bans-ն այժմ վերադարձնում է վերին մակարդակի դաշտերի նույն հավաքածուն՝ անկախ նրանից, թե որ հարցումն է առաջացրել պատասխանը։ Նախկինում կալենդարային արգելքներ չունեցող երկրի հարցումը, չճանաչված ppid-ը կամ բազայի սովորական համընկնումը կարող էին բաց թողնել տարբեր դաշտեր (օրինակ՝ country, covered_countries, ppid)։ Այժմ յուրաքանչյուր պատասխան հետևողականորեն ներառում է as_of, bans_by_country, countries_not_covered, country, covered_countries, current_bans, is_ban_active, lang, page_url, ppid, relevant_countries, source, success, summary, total_bans և upcoming_bans (null կամ դատարկ, երբ կիրառելի չէ)՝ դյուրացնելով հաճախորդի կողմի վերլուծությունը։

Ինը նոր ապրանք՝ ըստ ծառայության։ Դիրքի վրա հիմնվածները ընդունում են lat/lon կամ city + country (քաղաքը մենք ինքներս ենք geocode անում ձեզ համար)՝ /api/v2/data/truck-parkings, /api/v2/data/shops, /api/v2/data/showers, /api/v2/data/restaurants, /api/v2/data/industrial, /api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest (կայաններ՝ դասակարգված վառելիքի տեսակի գնով) և /api/v2/data/internet-points; արդյունքները պարունակում են distance_km և սահմանափակված են radius-ով։ /api/v2/data/vignettes-ը պատասխանում է՝ արդյոք երկիրը պահանջում է վինիետ, ընթացիկ գներով։ Առկա pois արտադրանքն այժմ աջակցում է lon և radius՝ ինչպես փաստագրված է, իսկ fuel արտադրանքի mode=nearest ռեժիմը նույնպես ընդունում է lon։ Բոլոր ինը հասանելի են sandbox-ում։

/api/v1/data/truck-bans-ի յուրաքանչյուր արգելք այժմ ներառում է restriction_type (General / Local / Sunday / Holiday / Seasonal), restriction_details (ազդակիր ճշգրիտ տարածքը կամ ճանապարհները) և min_weight_tons։ details_url-ն այժմ ուղղորդում է nakordoni.eu-ի՝ ըստ երկրի էջեր։ Նոր ընտրովի lang պարամետրը ընտրում է երկրների անունների և ամփոփման լեզուն. կանխադրվածն այժմ անգլերենն է։

Սխալ ?ppid=-ն այժմ վերադարձնում է իրական պատճառը կարճ "Request failed"-ի փոխարեն. սխալը նշում է պարամետրը, սպասվող id_<number> ձևաչափը և ուղղորդում է դեպի /api/v1/data/checkpoints. stats, forecast, update-info, weather և bus-carriers պարամետրերի աղյուսակներն այժմ ցույց են տալիս id_13 օրինակը բոլոր 25 լեզուներով.

Պորտալի վերափոխված միջերեսը (վերևի գոտի, պատկերակներով կողային վահանակ, KPI վահանակ, քարտային դասավորություն) այժմ լռելյայն է բոլոր մուտք գործած մշակողի հաշիվների համար՝ նախատեսված օգոստոսի 10-ի գործարկումից շուտ. Դասական դասավորությանը ցանկացած պահի վերադառնալու համար օգտագործեք ?v=1 ։

Մշակողի պորտալի բոլոր էջերը՝ գլխավոր, փաստաթղթեր, վահանակ, AI Studio, փորձարկման միջավայր, հարցատոմսեր, հայտեր, արտահանում, ավտոպարկ, նորություններ, փոփոխությունների մատյան և հաշվի էջերը, այլևս չեն բեռնում որևէ գովազդային սկրիպտ կամ գովազդային տեղ։ Սա վերաբերում է ամբողջ պորտալին, ոչ միայն մուտքի ու գրանցման էջերին, ինչպես նախկինում։

Պլանավորեք ամբողջ սահմանային ուղևորությունը մեկ հարցմամբ՝ /api/v2/data/route-plan-ը վերադարձնում է երթուղին, դրա վրա իրապես գտնվող անցակետերը կենդանի հերթով կամ ձեր ժամանման ժամի կանխատեսմամբ, և կանգառները, որոնք վարորդն իրականում կատարում է՝ հանգիստ, սնունդ, վառելիք՝ մեկ ժամանակագրության վրա։

Սահմանը այդ ժամանակագրության մասն է։ Երկար հերթը հաշվվում է որպես արդեն հասունացած ընդմիջում և զրոյացնում է ղեկի մոտ անցկացրած ժամանակը, ուստի երեք ժամ սպասելը երբեք չի ներկայացվում որպես երեք ժամ գումարած ընդմիջումների ամբողջ շարք, որ ոչ ոք չի արել։ Մարդատար մեքենաների համար գործում է անվտանգ վարման մոդելը. ավտոբուսներն ու բեռնատարները ստանում են ԵՄ 561/2006 պարտադիր հանգիստը, իսկ ավտոբուսների սպասարկման ժամանակը ճշգրտված է ավելի քան 1000 լիցենզավորված միջազգային չվացուցակի հիման վրա։ Ավելացրեք stop_places=1, որպեսզի յուրաքանչյուր կանգառ ստանա իրական հանգստի գոտի կամ լցակայան, և via=lat,lon՝ այլ անցակետով անցնելու համար։

Նոր՝ պորտալի ընտրացանկում. Ներկայացում — nakordoni տվյալների հարթակի կենդանի, միշտ արդիական ներկայացում՝ հարմարեցված ձեր շուկային (ապահովագրություն, ճամփորդություն, լոգիստիկա, փոխադրողներ, մեդիա, նավարկում, վառելիք, ֆինտեխ, հանրային հատված կամ անձնական նախագծեր)։ Այն ցույց է տալիս հարթակի իրական 30-օրյա ծավալները, ձեր սեփական API-ի օգտագործումը, արձագանքման ժամանակի և սահմանաչափերի վիճակագրությունը, ինչպես նաև սակագնի առաջարկ, երբ ձեր կանչերը հասնում են անվճար մակարդակի սահմաններին։ Ընտրեք կամ հաստատեք ձեր շուկան (կամ շուկաները) էջում, ձեր պրոֆիլում կամ գրանցման ժամանակ։ Առաջին այցելության ժամանակ այն բացվում է ինքնաբերաբար. ինքնաբաց թողնելը կարելի է անջատել հենց էջում։

Եթե օգնականի մոտ հոսքը միացված է, բայց կանչը չի բերում այդ հոսքին անհրաժեշտ համատեքստը, օրինակ՝ queue առանց ppid-ի, հոսքն այժմ բաց է թողնվում մինչև որևէ հարցում կատարելը և չի գանձվում։ Նախկինում այն միևնույն է կանչվում էր, ձախողվում և այնուամենայնիվ արժենում մեկ միավոր։ Ստուդիան ցույց է տալիս, թե ինչ է պետք յուրաքանչյուր հոսքին, համատեքստը լրացնելուն զուգահեռ վերահաշվարկում է գինը և արդյունքները նշում է ✓ կատարվեց / ⊘ բաց թողնվեց, առանց վճարի / ✕ ձախողվեց. API-ն վերադարձնում է data.feeds_skipped , որը հստակ ասում է՝ որ պարամետրը փոխանցել։

Պատասխաններն այլևս չեն հիշատակում հոսքեր, տվյալների աղբյուրներ կամ որևէ տեխնիկական բան. բացակայող հոսքը վերջնական օգտատիրոջ համար առավելագույնը մեկ պարզ նախադասություն է, երբեք ոչ ներքին անուն։ Միայն ոչ պարտադիր զտիչներ ունեցող հոսքերը (օրինակ՝ fuel -ը՝ նեղացված մի երկրի վրա, որի մասին տվյալներ չունենք) այժմ վերադառնում են լայն տվյալների բազմությանը՝ ոչինչ չվերադարձնելու փոխարեն։

Նոր՝ /{lang}/developers/studio. Կառուցեք AI օգնական, որը պատասխանում է ձեր բովանդակությունից և մեր կենդանի սահմանային տվյալներից։ Տվեք մեզ ձեր markdown-ը կամ պարզապես նշեք էջերը, և մենք դրանք կբեռնենք ու կինդեքսավորենք. դուք սպասարկում եք միայն ձեր սեփական ֆայլերը։ Ընտրեք՝ մեր որ հոսքերը կարող է օգտագործել (հերթ, կանխատեսում, այլընտրանքներ, օրական վիճակագրություն, վառելիք, բեռնատարների արգելքներ, առևտրային կիրակիներ, տոներ, ճանապարհների վիճակ, ավտոբուսային փոխադրողներ, POI, արժույթ), ընտրեք մոդելի մակարդակ (արագ / հավասարակշռված / պրո — հենց դա է սահմանում գինը), գրեք ձեր սեփական հրահանգները {{feed.slug}} տեղապահներով, որոնք հստակ նշում են, թե որտեղ են մեր տվյալները հայտնվում պատասխանում, և ավելացրեք ձեր սեփական եզրափակիչ նախադասությունը, որը կցվում է ամեն պատասխանի։ Պատրաստի ձևանմուշներ՝ անձնական ճամփորդական օգնական, աշխատանքային/բեռնափոխադրման օգնական, ապահովագրության և Կանաչ քարտի վաճառքի օգնական։

Փորձարկեք այն ստուդիայում (օրական 30 պատասխան՝ ձեր API-ի քվոտայից առանձին), ապա արտադրական միջավայրում կանչեք GET /api/v2/data/assistant-custom?assistant_id=N&q=…հասցեով։ Գինը մեկ պատասխանի համար = մոդելի մակարդակի միավորներ + 1 միավոր՝ յուրաքանչյուր միացված հոսքի համար, վերադարձվում է X-Devapi-Units-ում։ Ապրանքը միայն v2-ում է. v1 URL-ը վերադարձնում է unsupported_version։ Առկա assistant ապրանքը մնում է անփոփոխ։

Յուրաքանչյուր օգնական աշխատում է հարթակի բովանդակության քաղաքականության ներքո, որը գերակայում է ձեր հրահանգներին. արգելվում է ներկայանալ որպես պաշտոնատար անձ, օգնել շրջանցելու սահմանային կամ մաքսային հսկողությունը, հորինել թվեր, օգտագործել հայհոյանք։ Ստուգվում են և՛ հրահանգները, և՛ պատասխանները. արգելափակված կանչերը գրանցվում են։

Նոր՝ իրական MCP սերվեր https://nakordoni.eu/mcp հասցեով, որը API-ի անվտանգ, միայն կարդալու ենթաբազմությունը (status, checkpoints, border queue, live queue, forecast) տրամադրում է որպես MCP գործիքներ։ Նույն API բանալին և քվոտան, ինչ REST API-ում։ Սերվերի քարտը՝ /.well-known/mcp/server-card.json հասցեով։ Տե՛ս MCP սերվեր բաժինը փաստաթղթերում։

Ստորև նկարագրված վերանվանումը «Live Queue & Freshness API»-ի իրականում չէր հասել փաստաթղթերի էջին։ Էջը յուրաքանչյուր ապրանքի վերնագիրը ցուցադրում է թարգմանության որոնման միջոցով, որը վերջնակետի վերնագրին դիմում է միայն այն դեպքում, երբ թարգմանություն չկա, իսկ թարգմանությունն արդեն կար՝ սառեցված հին անվան վրա, միջերեսի բոլոր 25 լեզուներով։ Այսուհետ այն գերակայում է հիմքային վերնագրի ցանկացած ապագա թարմացմանը, մինչև ինքն էլ չթարմացվի։

Թարգմանության բանալին վերանվանվել է բոլոր 25 լեզուներով, ուստի փաստաթղթերի էջն այժմ համընկնում է։ Վերջնակետը, պարամետրերը կամ պատասխանը չեն փոխվել. միայն վերնագրի տեքստը։

Եթե հաճախ եք հարցումներ անում կենդանի հերթի տվյալների համար, հնարավոր է՝ ավելորդ ծախսում եք ծանր քվոտան։ /update-info -ը ստանդարտ դասի է և արդեն վերադարձնում է ընթացիկ ցուցանիշը.

GET /api/v1/data/update-info?ppid=id_13

Այն վերադարձնում է queue_now, freshness, age_minutes, is_realtime, status, timestamp և timezone։ Օգտագործեք այն հաճախակի թարմացման համար՝ ձեր ստանդարտ օրական քվոտայի հաշվին, իսկ /queue, /multi և /forecast (բոլորը ծանր դասի) թողեք այն դեպքերի համար, երբ ձեզ պետք են wait_min, միտման դաշտերը կամ պատմությունը։

Հենց վերջնակետում ոչինչ չի փոխվել. միայն դրա փաստաթղթերում։ Այն նշված էր որպես «Data Freshness API», իսկ նկարագրությունը հիշատակում էր միայն թարմության գնահատականը, երբեք՝ queue_now-ը, ուստի հեշտ էր բաց թողնել։ Այժմ այն կոչվում է «Live Queue & Freshness API»՝ վերադարձվող դաշտերի հստակ թվարկումով։ Շնորհակալություն այն մշակողին, ով բարձրացրեց հարցը։

Որոշ ձախողված հարցումներ վերադարձնում էին HTTP 200 ՝ ok: true -ով, իսկ սխալը թաքնված էր data -ի ներսում, ուստի փաստաթղթավորված if (!ok) throw ձևանմուշը չէր կարողանում դրանք հայտնաբերել, և կանչը միևնույն է գանձվում էր։ Այդ կանչերն այժմ վերադարձնում են HTTP 400 ՝ ok: false -ով և պատշաճ error.code / error.message-ով, ինչպես փաստաթղթավորված է։ Նկատվել է fuel-cities -ում՝ չաջակցվող երկրի դեպքում, և travel-matrix -ում՝ սխալ կոորդինատների դեպքում։

Առանձին. պարտադիր պարամետրի բացակայության դեպքում վերադարձվում էր 500 internal_error ՝ 400 bad_request -ի փոխարեն (ներքին ծառայության 4xx պատասխանի մարմինը դեն էր նետվում մինչև դրա կարգավիճակը կարդալը)։ Այժմ վերադարձվում է 400 bad_request ՝ ներքին ծառայության հաղորդագրությամբ, օրինակ՝ search առանց ?name=-ի։

Հաջողված պատասխաններն անփոփոխ են՝ բայթ առ բայթ — նույն դաշտերը, նույն պարամետրերը, քվոտայի նույն արժեքը։ Եթե ձեր հաճախորդն արդեն ճյուղավորվում է ok-ով, փոփոխություն պետք չէ։ Իսկ եթե այն անտեսում էր ok -ը և ուղղակիորեն կարդում data -ը, այժմ կտեսնի սխալի ծրարներ այն կանչերի վրա, որոնք առանց այդ էլ միշտ ձախողվում էին։

Ուղղվել է սխալ, որի պատճառով /multi -ը կարող էր վերադարձնել հերթի սխալ քանակ որոշ անցակետերի համար՝ հիմնականում բալկանյան և Հունգարիա–Սերբիա սահմանին, ամեն անգամ, երբ դրա քեշը սառն էր։ Պահեստային ուղին կարդում էր աղյուսակ, որը այդ անցակետերի համար հերթի տվյալներ չի պարունակում, և անկապ արժեքները ներկայացնում էր որպես մեքենաների քանակ։ Չափված օրինակներ. 12 մեքենա ունեցող անցակետը ցույց էր տալիս 6, իսկ իրական հերթեր ունեցող մի քանիսը՝ 0։

Երեք փոփոխություն, որոնք կարող եք նկատել.

• found: false այժմ նշանակում է, որ հերթի թարմ տվյալներ իսկապես չկան։ Նախկինում կարող էիք ստանալ found: true ՝ հորինված queue_now: 0-ով։
• wait_status, trend_percent և trend_direction այժմ վերադարձվում են նաև «սառը» հարցումների դեպքում. նախկինում դրանք null էին։
• Վերջնակետը պահեստային ուղուն է անցնում նաև այն դեպքում, երբ իր քեշավորված պատկերը հնացած է (24 ժամից ավելի), ոչ միայն երբ այն բացակայում է։

Հարցման պարամետրերում, քվոտայի արժեքում կամ պատասխանի կառուցվածքում փոփոխություններ չկան։

Ուղղվել է սխալ, որի պատճառով յուրաքանչյուր /multi կանչ հաշվարկվում էր երկու անգամ՝ նախ ընդհանուր 1 միավոր ստուգմամբ, ապա կրկին էնդփոյնթի սեփական փոփոխական արժեքի բանաձևով (N PPID × ենթամթերքներ)։ Այժմ կանչն արժե ուղիղ ⌈(N×M)/2⌉ միավոր, ինչպես փաստագրված է, առանց լրացուցիչ գանձման։

Նաև փաստաթղթերի էջում ավելացվել է քվոտայի դասի կրծքանշան (Standard/Heavy) յուրաքանչյուր ապրանքի համար, որպեսզի մեկ հայացքից պարզ լինի, թե որ օրական քվոտան է օգտագործում էնդփոյնթը։

country և countries միավորվեցին մեկ պարամետրի մեջ (1-15 ստորակետով բաժանված կոդ)։ Նոր compare_to պարամետր՝ երկրների միջև նույն կամ տարբեր տոների համեմատում, համատեղվում է upcoming+days-ի հետ։ lang-ն այժմ ընդունում է մի քանի լեզու (ավելացնում է names օբյեկտ)։ days=0 կամ բացակայելը այժմ նշանակում է առանց սահմանափակման upcoming ռեժիմում։

Պաշտոնական պետական տոներ Եվրոպայի յուրաքանչյուր երկրի համար՝ ամսաթվեր, տեղական անվանումներ և տեսակ։ Հիմնված է նույն Nager.Date / OpenHolidaysAPI ծառայության վրա (տեղական հաշվարկված Կոսովոյի օրացույցով), որը սնուցում է nakordoni.eu-ի տոների օրացույցի էջը և կանխատեսման համակարգի օրացուցային գործոնները։

• ?country=PL&year=2026 — մեկ երկրի ամբողջ տարվա տոների ցանկ
• ?upcoming=1&days=30 — երկրների գծով առաջիկա տոների հարթ ցանկ
• Առանց պարամետրերի — հիմնական երկրների խմբի ինդեքս՝ յուրաքանչյուրի հաջորդ տոնով

Ավելացվեց currency արտադրանքը՝ EUR-ի հիմքով փոխարժեքներ PLN, CZK, HUF, USD, GBP, CHF, NOK և UAH-ի համար, ստացված Frankfurter-ից (ECB) և քեշավորված 6 ժամ։ Առանց պարամետրերի, միշտ վերադարձնում է փոխարժեքների ամբողջական աղյուսակը։ Տե՛ս փաստաթղթերը։

Ներդրե՛ք եվրոպական բեռնատարների երթևեկության իրական ժամանակի արգելքները ձեր սեփական կայքում՝ անվճար iframe վիջեթ՝ 3 դիզայնով (light, dark, board), 5 լեզվով (en, uk, pl, de, ru), ըստ երկրի ընտրովի զտիչով և «active now» կենդանի կարգավիճակով։ API բանալի պետք չէ։ Կարգավորե՛ք և պատճենե՛ք կոդն այստեղ՝ nakordoni.eu/en/for_truck_drivers/traffic_bans/widget։ Նախընտրու՞մ եք չմշակված տվյալներ։ truck-bans API արտադրանքը և հանրային JSON հոսքը դեռ հասանելի են։

Երեք հավելում, բոլորն էլ հետընթաց համատեղելի — v1-ն անփոփոխ է։

Ըստ endpoint-ի տարբերակավորում։ Այժմ կա /api/v2/ բազային URL։ Այն ըստ endpoint-ի է. միայն այն endpoint-ները, որոնք իրականում փոխվել են, v2-ում վարվում են այլ կերպ. մնացած յուրաքանչյուր endpoint թափանցիկ կերպով մատուցում է իր v1 պատասխանը (այնպես որ /api/v2/data/queue = նույն տվյալները, ինչ v1-ում, պարզապես "api_version":"v2"-ով)։ Աշխատող endpoint-ները տեղափոխելու կարիք չկա։

border v2-ն ուղղորդված է։ Ուղու հերթականությունը ճամփորդության ուղղությունն է․

GET /api/v2/data/border/1/2/6   → buses UA→PL (Ukrainian-side crossings)
GET /api/v2/data/border/2/1/6   → buses PL→UA (Polish-side crossings)

Յուրաքանչյուր անցակետ նաև ստանում է direction {from,to} օբյեկտ և stale բուլյան, իսկ ?max_age_min=N վերադարձնում է միայն վերջերս թարմացված անցումները։ (v1 border-ն դեռ վերադարձնում է սահմանի երկու կողմերն էլ՝ անկախ հերթականությունից — անփոփոխ։)

Ինտերակտիվ Sandbox։ Մուտք գործած մշակողներն այժմ կարող են փորձարկել ցանկացած endpoint բրաուզերից այստեղ՝ Developers → Sandbox — ընտրե՛ք endpoint, տարբերակ և ձեր բանալիներից մեկը, փոփոխե՛ք պարամետրերը և տեսե՛ք կենդանի պատասխանը։ Sandbox-ի փորձարկումն ունի իր առանձին օրական բյուջեն (50 calls/day) և երբեք չի շոշափում ձեր կենդանի API քվոտան։

Փաստաթղթերն այժմ բաժանված են ըստ endpoint-ի (Developers → API Docs)՝ տարբերակի ընտրիչով այն endpoint-ների վրա, որոնք ունեն մեկից ավելի տարբերակ։

Սպասման ժամանակի բանաձևի մեջ ներդրվեցին երկու նոր գործոն՝ առկա section_mode-ի և եղանակի ճշգրտումների կողքին․

• service_rate — ներկայումս մշակվող չափված մեքենա/րոպե ցուցանիշը՝ համեմատած անցակետի կարգավորված բազային ցուցանիշի հետ։ Բազմապատկող, սահմանափակված 0.5x-1.5x։
• shift_change — անցակետի սեփական տեղական 08:00/20:00 սահմանապահների հերթափոխի ազդեցությունը։ Գումարվող (րոպեներ), ոչ բազմապատկող — կիրառվում է միայն հերթափոխից +/-60 րոպեի սահմաններում, պահանջում է նվազագույն նմուշային պատմություն, սահմանափակված է +/-120 րոպեով։

advanced_wait_min-ն այժմ round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min է։ Երկու գործոններն էլ նաև արտացոլվում են driver_reported.prognosed_advanced_wait_min-ում՝ պատմական համեմատությունների համար։

Անվտանգության/գաղտնիության վերանայման շրջանակում հեռացվեցին հետևյալ դաշտերը — դրանք բացահայտում էին ներքին իրականացման մանրամասներ (մեր վերընթաց տվյալների աղբյուրի տաքսոնոմիան, DB row ID-ները, ներքին pipeline-ի ծանոթագրությունները, չօգտագործվող/մեռյալ դաշտերը)՝ առանց իրական արտադրանքային արժեքի․

• id և corrected — հեռացվեցին queue row օբյեկտներից
• source (չմշակված տող, օր․ "line") — հեռացվեց queue, multi և update-info-ից։ update-info-ն և multi-ի update_info բլոկը դեռ կրում են source_category/source_label_en (փոքր հանրային բառապաշար). queue-ն և multi-ի queue բլոկն այլևս ընդհանրապես չեն կրում որևէ source դաշտ
• traffic_status — հեռացվեց border-ից. այն միշտ null էր և երբեք չէր լրացվում համակարգի որևէ մասով

Եթե ձեր ինտեգրումը կարդում է այս դաշտերից որևէ մեկը, խնդրում ենք թարմացնել այն — տե՛ս ընթացիկ դաշտերի ցանկը համապատասխան արտադրանքի փաստաթղթերի էջում։

Օրական քվոտայի օգտագործումը (usage.used յուրաքանչյուր պատասխանում) այժմ կարող է լինել տասնորդական արժեք (օր․ 67.5) միշտ ամբողջ թիվ լինելու փոխարեն։ Սա queue-advanced-ի կոտորակային դրույքով գանձման կողմնակի հետևանք է — տե՛ս ստորև։ usage.limit-ը չի ազդվում և միշտ ամբողջ թիվ է։ Եթե ձեր հաճախորդը խստորեն տիպավորում է usage.used-ը որպես ամբողջ թիվ, խնդրում ենք ընդլայնել այն՝ տասնորդական/float ընդունելու համար։

Այս երեք արտադրանքներն այժմ վերադարձնում են նույն կենդանի-կարգավիճակի դաշտերը, որ ցույց է տալիս կայքը՝ wait_status (green/yellow/red, հիմնված այս անցակետի սեփական վերջին պատմության վրա) և trend_percent/trend_direction (up/up-slight/down/down-slight/stable, համեմատելով վերջին 3 ժամը)։ Զուտ հավելյալ։

/api/v1/data/queue-ի data[] row-երը նախկինում ունեին wait_time: null աղբյուրների մեծ մասի համար — միայն մի քանի վերընթաց հոսք է ուղղակիորեն հայտնում սպասման ժամանակ։ Առանց դրա row-երն այժմ ստանում են ստանդարտ գնահատականը՝ նշված նոր wait_time_estimated բուլյանով, այնպես որ կարող եք տարբերել իրական հայտնված ցուցանիշը հաշվարկվածից։

queue-advanced-ն այժմ արժե 1.5 միավոր մեկ կանչի համար՝ 1-ի փոխարեն (արտացոլելով լրացուցիչ traffic/weather/driver-report որոնումները, որ այն կատարում է) — տե՛ս usage.used վերևում։ Պատասխանը նաև այլևս չի ներառում total_crossing_time, իսկ driver_reported-ն այժմ պարզապես {wait_min, ts, age_min} է — նախկին կանխատեսում-իրականություն համեմատության դաշտերը (prognosed_wait_min, diff_min, historical_section_mode, historical_weather և այլն) հեռացվել են։ section_mode, weather, advanced_wait_min և exceeds_crossing_time-ն անփոփոխ են։

/api/v1/data/truck-bans-ն այժմ վերադարձնում է bans_by_country-ում յուրաքանչյուր երկրի համար status (active/clear) գումարած active_window, next_window, local_time և tz — հաշվարկված այդ երկրի սեփական ժամային գոտում, այնպես որ այլևս պետք չէ ինքներդ գնահատել չմշակված արգելքի պատուհանները ժամացույցի նկատմամբ։ Պատասխանին նաև ավելանում է վերին մակարդակի covered_countries ցանկ և as_of UTC ժամանակի դրոշմ։

GET /api/v1/data/truck-bans?country=PL

Զուտ հավելյալ — առկա current_bans/upcoming_bans/bans_by_country դաշտերն անփոփոխ են։ Անհայտ ?country=-ն այժմ վերադարձնում է դատարկ արդյունք countries_not_covered-ով՝ յուրաքանչյուր երկրի արգելքների փոխարեն։

Նոր ընտրովի արտադրանք, որը ստանդարտ սպասման ժամանակը հարմարեցնում է կենդանի երթևեկության հոսքին և եղանակին։ Վերադարձնում է յուրաքանչյուր ճշգրտման ամբողջական վերլուծությունը։

GET /api/v1/data/queue-advanced?ppid=id_13

Տրվում է ըստ հարցման — այն միացնելու համար բացե՛ք Data տոմս ձեր վահանակից։

/api/v1/data/border-ն այժմ ճիշտ հաշվարկում է wait_min-ը պատասխանի յուրաքանչյուր անցակետի համար՝ համապատասխանելով queue և multi արտադրանքներին։ Նախկինում այս դաշտը միշտ null էր։

/api/v1/data/forecast-ն այժմ հուսալիորեն օգտագործում է v4 անսամբլի մոդելը ցանկացած prediction_steps արժեքի համար (նախկինում որոշ ոչ ստանդարտ հորիզոններ կարող էին լուռ վերադառնալ ավելի հին մոդելի)։ Անսամբլը սնուցող եղանակի գործոնը նույնպես շտկվել է և այժմ իրապես արտացոլում է կենդանի պայմանները (անձրև, ձյուն, քամի, մառախուղ)՝ միշտ անհասանելի հայտնելու փոխարեն։

Հաստատված մշակողներն այժմ կարող են ներբեռնել ժամային միջինացված պատմական սահմանային հերթի տվյալները մինչև 5 անցակետի համար (գլորվող պատուհան մինչև 90 օր) որպես CSV կամ NDJSON նոր Data export ներդիրից։ Տվյալները միայն հրապարակված են և որակի ստուգված. ժամանակի դրոշմերը UTC-ով են։ Մուտք է պե՞տք։ Բացե՛ք Data տոմս։

Դեռ կայք չունե՞ք։ Այժմ կարող եք ստեղծել մշակողի հաշիվ՝ նկարագրելով, թե որտեղ և ինչպես եք նախատեսում օգտագործել մեր տվյալները, կենդանի էջի URL մուտքագրելու հարկադրման փոխարեն։ Ավելացրե՛ք իրական URL-ն ավելի ուշ ձեր վահանակից (Account & data → Your project) հենց որ ձեր կայքը կամ հավելվածը կենդանի դառնա — այդ էջում nakordoni.eu-ին ուղղված տեսանելի հետադարձ հղումը պահանջվում է մեր Պայմաններով։

Մշակողներն այժմ կարող են ներկայացնել իրենց սահմանին առնչվող նորությունները Nakordoni-ի նորությունների հոսքին։ Եթե մեր խմբագիրները հրապարակեն այն, դուք ստանում եք ինդեքսավորվող dofollow հետադարձ հղում դեպի ձեր ծառայությունը (հրապարակողի ստորագրություն + աղբյուրի տող), և մենք անվճար թարգմանում ենք հոդվածը բոլոր 24 լեզուներով։

Շաբաթը մեկ հոդված անվճար է. լրացուցիչ հոդվածները վճարովի հավելում են։ Ընտրե՛ք 'մենք կարող ենք թեթևակի խմբագրել + ավելացնել ներքին հղումներ' կամ 'հրապարակել այնպես, ինչպես կա'։ Ներկայացրե՛ք և հետևե՛ք վերանայման կարգավիճակին այստեղ՝ Developers → Submit news։

Multi-Checkpoint API-ն (/api/v1/data/multi) այժմ քվոտան գանձում է որպես ⌈(N PPIDs × sub-products) / 2⌉ — համարժեք առանձին կանչերի արժեքի կեսը։ 10 անցակետի հարցումը երկու sub-product-ով այժմ արժե 10 միավոր՝ 20-ի փոխարեն։ X-Devapi-Units վերնագիրը և պատասխանում meta.units_consumed-ն արտացոլում են զեղչված գումարը։

Ստացե՛ք կենդանի հերթի կարգավիճակ և տվյալների թարմություն մինչև 20 անցակետի համար մեկ API կանչում — նախատեսված վահանակ ստեղծողների համար, ովքեր ներկայումս ցիկլով հարցում են անում բազմաթիվ PPID-ների։

Քվոտան արդար հաշվարկվում է որպես N PPIDs × sub-products հարցված, այնպես որ ընդհանուր օգտագործումը նույնական է առանձին կանչերին — բայց մեկ ուղևորությամբ՝ բազմաթիվի փոխարեն։ GreenTravel-ի ոճի ձևանմուշները ժամում 24+ կանչից իջնում են մինչև 2։

GET /api/v1/data/multi?ppids=id_2,id_13,id_15,id_59&include=queue,update-info&lang=en

• include=queue — ընթացիկ queue_now, գնահատված wait_min, տվյալների տարիք և անցակետի անուն
• include=update-info — տվյալների թարմություն, աղբյուրի դասակարգում, տարիք վայրկյաններով/րոպեներով
• Առավելագույնը 20 PPID մեկ հարցման համար. համատեղե՛ք երկու sub-product-ը մեկ կանչում՝ վահանակի ամբողջական տվյալների համար
• Պատասխանը ներառում է meta.units_consumed, այնպես որ կարող եք ճշգրիտ հետևել քվոտայի օգտագործմանը

queue արտադրանքի պատասխանն այժմ ներառում է վերին մակարդակի snapshot օբյեկտ՝ վերջին իրական ժամանակի տվյալներով և հաշվարկված կանխատեսված սպասման ժամանակով — նույն բանաձևը, որ օգտագործվում է nakordoni.eu-ի hero բաժնում․

snapshot.queue_now  — current cars in queue
snapshot.wait_min   — prognosed wait time (minutes)
snapshot.updated_at — when the queue data was recorded
snapshot.age_min    — minutes since last update
snapshot.source     — data source identifier

data զանգվածը (պատմական գրառումներ) անփոփոխ է — սա զուտ հավելյալ ավելացում է։ Այն հաճախորդները, որոնք չեն կարդում snapshot, չեն ազդվում։

Հարցում արե՛ք տվյալ սահմանի + տրանսպորտի տեսակի բոլոր անցակետերը մեկ կանչում՝ յուրաքանչյուր PPID-ի համար առանձին հարցում անելու փոխարեն։

GET /api/v1/data/border/{origin}/{destination}/{crossing_type}

• Աջակցում է մեկ նպատակակետ երկիր, ստորակետով բաժանված ցանկ կամ all՝ բոլոր վերահսկվող հարևանների միանգամից ընդլայնման համար։
• Արդյունքները դասավորված են ըստ queue_now աճման (ամենակարճ հերթն առաջինը)։
• Ամբողջովին տեղայնացված. ավելացրե՛ք ?lang=uk (կամ մեր 22 աջակցվող լեզուներից որևէ մեկը)՝ այդ լեզվով անցակետերի անվանումներ ստանալու համար։

Գտե՛ք անցակետի PPID արժեքներն ըստ անվան՝ առանց ամբողջ ցուցակը թերթելու։

GET /api/v1/data/search?name=Krakovets,Shehyni&lang=en

• Ընդունում է մեկ անուն կամ ստորակետով բաժանված ցանկ (մինչև 20)։
• Որոնում է բոլոր 24 թարգմանության լեզուներում — փոխանցե՛ք անունը ուկրաիներեն, լեհերեն, գերմաներեն կամ որևէ աջակցվող լեզվով, և այն կհամընկնի։
• Վերադարձնում է այդ վայրի բոլոր PPID-ները՝ խմբավորված ըստ տրանսպորտի տեսակի (car / bus / pedestrian / truck)։

alternatives արտադրանքն այժմ ընդունում է ?lang= բոլոր 22 աջակցվող լեզուներով (նախկինում միայն 12-ն էր)։

Նոր crossing_type պարամետրը թույլ է տալիս վերասահմանել տրանսպորտի տեսակի զտիչը — օր․ փոխանցե՛ք crossing_type=4՝ մեքենայի այլընտրանքներ ստանալու համար նույնիսկ bus PPID-ից հարցում անելիս։

crossing_type_label դաշտը checkpoints, border և search պատասխաններում այժմ թարգմանվում է հարցված լեզվին բոլոր 22 աջակցվող լեզուներով։ Երկրի անվան դաշտերը (origin_name, destination_name) հետևում են նույն տեղայնացմանը։

Nakordoni Developer API պորտալը կենդանի է այստեղ՝ /en/developers։ Գրանցվե՛ք անվճար Explorer բանալիի համար (200 requests/day)՝ սահմանային հերթի տվյալներ, կանխատեսումներ, վառելիքի գներ, վարորդների POI-ներ և ավելին ստանալու համար։

Գործարկման պահին հասանելի արտադրանքներ՝ checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant։