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

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

On Fuel Prices, updated_at and the response's own age_hours/stale flag were running on different clocks: updated_at moves only when a price actually changes, but staleness was computed as if it moved on every confirmation. 46.7% of the priced index showed age_hours ≤48 and stale:false while updated_at was in fact more than 48 hours old, 12,620 stations over a week old. Each price now also carries confirmed_at — the last time we confirmed the price, hour-floored, never earlier than updated_at — and age_hours/stale are computed from it. updated_at's meaning is unchanged: use it when you want to know when the price last moved, use confirmed_at when you want to know how current it is right now. Not present on the frozen v1 contract.

Two language bugs, both silent: sending the canonical grade code as lang=pl (or any of the other 24 site languages) got fuel_type_local back in English regardless — only 10 languages were ever checked against the label table, so anything outside that list fell through to the default UI vocabulary rather than the language you asked for. Separately, lang=tr (or several other valid codes) answered station listings in Ukrainian, because an internal default of uk fired whenever the requested language did not sit in that same 10-language list. Both are fixed: the language you send is now the language you get, across all 25.

Also: brand on Nearby Fuel Stations no longer returns the raw ingest sentinel OTHER for the ~330 stations where we do not know the brand — it is null, consistent with every other unknown field in the response.

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։