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.

Шекара AI көмекшісі (/api/v1/data/assistant) бір кілт бес минут ішінде бір сұрақты екі рет қойғанда 503 internal_error — «Көмекші уақытша қолжетімсіз» — деп жауап беретін. Ешнәрсе қолжетімсіз болған жоқ: бұл жағдайлардың көпшілігінде жауап әлдеқашан есептеліп, қайтаруға дайын тұрған. Енді ол ok: true және HTTP 200 арқылы қалыпты түрде қайтарылады.

Егер қайталама сұраныс бірінші жауап әлі жазылып жатқанда келсе, шақыру енді 503-тің орнына 429 қайтарады, оның error.code мәні — duplicate_request, сондықтан қайталау саясаты «сәлден кейін қайта сұраңыз» дегенді нақты іркіліспен шатастырмайды. Бұл екі жағдай да сіздің тіркелгіңіздің қате деңгейінде сервер қатесі ретінде саналатын; енді саналмайды. Сұраныста ештеңе өзгермейді — параметр де, нұсқа да. duplicate_request анықтамалықта басқа қате кодтарымен бірге көрсетілген.

Truck Parking (/api/v2/data/truck-parkings) name мәні null және address өрісі бос жазбаларды қайтаратын — Bensheim маңында 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, AdBlue үшін DEF, сондай-ақ премиум дизель мен бензиннің бірқатар бренд атауы. Тану реті өзгерген жоқ, сәйкестендіру дәл күйінде қалады, сондықтан бұрын жұмыс істеген ешбір атау бүгін басқа мағына бермейді, ал жаңа атау тек бос жауапты бағасы бар жауапқа айналдыра алады. Сонымен қатар анықтамалық құжаттама мен эндпоинт сипаттамалары сайттың 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 тілінің барлығында шығады және v1/v2 тұжырымына қайта оралудың орнына v4-тегі бір мақсат ережесін нақты айтады.

/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 (Freight Transport) және 9 (Freight Transport up to 7.5 t) деп бөлген. Өткізу пунктінде бұл бөліну шын мәнінде бар, бірақ оны бірде-бір интегратор пайдалана алмайды: UA-PL шекарасында v2-ден 9 сұрағанда 70 жүк өткелінің 21-і қайтарылды және бұл туралы ештеңе айтылмады. v4 9 сұрауына барлық жүк жолақтарымен жауап береді және 8 дегенді 9 лақап аты ретінде қабылдайды. Әр жол өзінің crossing_type мәнін алып жүреді, сондықтан біріктірілген жауапты тексеруге болады.

v1 мен v2-де destination=all 2026 жылғы 6 қазанға дейін жұмысын жалғастырады және сол уақытқа дейін 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 дегенді Freight Transport, ал 9 дегенді Freight Transport up to 7.5 tons деп белгілейді және әрқашан солай болған. Егер жүк көлігінің кодын параметр туралы кеңестен таңдаған болсаңыз, өзіңіз ойлағанға қарама-қарсы жолақты сүзгілеп келдіңіз. Барлық жерде түзетілді, ал v3 бұл таңдауды мүлдем алып тастайды.

API шарттары v1.1 v1.0 күшіне енгенге дейін оны алмастырады және 2026 жылғы 6 қазаннан бастап қолданылады. Оларды басқару панелінде қабылдаңыз.

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 маяк жауабы (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 қабылдайды (қаланы сіз үшін өзіміз геокодтаймыз): /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 өнімі өзгермейді.

Әр ассистент платформаның мазмұн саясаты аясында жұмыс істейді, ол сіздің нұсқауларыңыздан жоғары тұрады: лауазымды тұлға болып көріну, шекара немесе кеден бақылауынан жалтаруға көмектесу, ойдан шығарылған сандар және дөрекі сөздер — тыйым салынған. Нұсқаулар да, жауаптар да тексеріледі; бұғатталған шақырулар журналға жазылады.

Жаңалық: https://nakordoni.eu/mcp мекенжайындағы нақты MCP сервері, ол API-дің тек оқуға арналған қауіпсіз ішкі жиынтығын (status, checkpoints, border queue, live queue, forecast) MCP құралдары ретінде ұсынады. REST API-мен бірдей 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 режимінде шектеу жоқ дегенді білдіреді.

Әрбір еуропалық ел бойынша ресми мемлекеттік мерекелер — күндер, жергілікті атаулар мен түрі. nakordoni.eu мереке күнтізбесі бетін және болжау жүйесінің күнтізбелік факторларын қуаттайтын дәл сол Nager.Date / OpenHolidaysAPI қызметіне негізделген (жергілікті есептелген Косово күнтізбесімен).

• ?country=PL&year=2026 — бір елге арналған толық жылдық мерекелер тізімі
• ?upcoming=1&days=30 — елдер бойынша алдағы мерекелердің жалпақ тізімі
• Параметрсіз — негізгі елдер жиынының индексі, әрқайсысының келесі мерекесімен

currency өнімі қосылды — PLN, CZK, HUF, USD, GBP, CHF, NOK және UAH үшін EUR негізіндегі айырбас бағамдары, Frankfurter (ECB) көзінен алынып, 6 сағат кэштеледі. Параметрсіз, әрдайым толық бағамдар кестесін қайтарады. құжаттаманы қараңыз.

Еуропалық жүк көліктерінің қозғалысына нақты уақыттағы тыйымдарды өз веб-сайтыңызға ендіріңіз — 3 дизайны (light, dark, board), 5 тілі (en, uk, pl, de, ru), міндетті емес ел бойынша сүзгісі және «active now» тірі күйі бар тегін iframe виджеті. 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-дің орнына 1.5 бірлік тұрады (ол орындайтын қосымша 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 енді кез келген prediction_steps мәні үшін v4 ансамбльдік моделін сенімді түрде пайдаланады (бұрын кейбір стандартты емес горизонттар үнсіз ескі модельге қайта оралуы мүмкін еді). Ансамбльді қоректендіретін ауа райы факторы да түзетілді және енді әрдайым қолжетімсіз деп хабарлаудың орнына тірі жағдайларды (жаңбыр, қар, жел, тұман) шынайы көрсетеді.

Бекітілген әзірлеушілер енді 5 бақылау бекетіне дейін (90 күнге дейінгі жылжымалы терезе) сағаттық орташаланған тарихи шекара кезегі деректерін жаңа Data export қойындысынан CSV немесе NDJSON түрінде жүктеп ала алады. Деректер тек жарияланған және сапасы тексерілген; уақыт белгілері 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⌉ ретінде есептейді — баламалы жеке қоңыраулардың жартысы құны. Екі sub-product-пен 10 бақылау бекетіне сұраныс енді 20-ның орнына 10 бірлік тұрады. Жауаптағы X-Devapi-Units тақырыбы мен meta.units_consumed жеңілдетілген мөлшерді көрсетеді.

Бір API қоңырауымен 20 бақылау бекетіне дейінгі тірі кезек күйі мен деректер жаңалығын алыңыз — қазір көптеген 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   — (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 параметрі көлік түрі сүзгісін ауыстыруға мүмкіндік береді — мыс. bus PPID-тен сұрағанда да машина баламаларын алу үшін crossing_type=4-ті беріңіз.

crossing_type_label өрісі checkpoints, border және search жауаптарында енді сұралған тілге барлық 22 қолдау көрсетілетін тілде аударылады. Ел атауы өрістері (origin_name, destination_name) сол локальға еріп жүреді.

Nakordoni Developer API порталы осында іске қосылды: /en/developers. Шекара кезегі деректеріне, болжамдарға, отын бағаларына, жүргізуші POI-леріне және басқаларға қатынау үшін тегін Explorer кілтіне (200 requests/day) тіркеліңіз.

Іске қосылуда қолжетімді өнімдер: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.