API dəyişiklik jurnalı

Eyni e-poçt ünvanı ilə Nakordoni Partners hesabına bağlı developer hesabları artıq xəbər göndərə və öz NakBus donanmasını (NakDriver / NakManager) partners.nakordoni.eu vasitəsilə idarə edə bilər, komanda rolları (Owner, Manager, Viewer) və iki portal arasında bir kliklə giriş ilə. Developer portalının səhifələri, API açarları, donanma son nöqtələri və tətbiqlər dəyişməz qalır.

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) eyni açar beş dəqiqə ərzində eyni sualı iki dəfə verdikdə 503 internal_error — “Assistant temporarily unavailable” — qaytarırdı. Əslində heç nə əlçatmaz deyildi: həmin halların əksəriyyətində cavab artıq hesablanmış və qaytarılmağa hazır idi. İndi o, ok: true və HTTP 200 ilə normal şəkildə qaytarılır.

Təkrar sorğu ilk cavab hələ yazılarkən gəldikdə, çağırış indi 503 əvəzinə 429 və error.code dəyəri duplicate_request ilə cavab verir; beləliklə təkrar cəhd siyasəti “bir azdan yenidən soruşun” vəziyyətini real sıradan çıxmadan ayıra bilir. Hər iki hal həm də hesabınızın xəta faizinə server xətası kimi yazılırdı; artıq yazılmır. Sorğunun özündə heç nə dəyişmir — nə parametr, nə versiya. duplicate_request istinad sənədində digər xəta kodları ilə birlikdə göstərilib.

Truck Parking (/api/v2/data/truck-parkings) name dəyəri null, address sahəsi isə boş olan qeydlər qaytarırdı — Bensheim yaxınlığında 50-dən 20-si. Bunlar yalnız koordinat kimi saxladığımız yerlərdir: nə göstərməyə, nə də sizin öz POI dəstinizlə uyğunlaşdırmağa bir şey verir. Onlar artıq bu məhsulun tərkibinə daxil deyil: indi yalnız adı olan məkanlar qaytarılır, hazırda Avropa üzrə 22 000-dən çox. Əgər adsız qeydləri özünüz süzürdünüzsə, həmin kod indi artıqdır, lakin zərərsizdir. Eyni radius və limit üçün cavablar qısalır və qayıdan hər qeyd istifadəyə yararlıdır.

Ayrıca, təxminən 10 000 dayanacaq name sahəsində xam koordinat cütü, məsələn 51.927301,10.14112, daşıyırdı, real ad isə address sahəsində idi. İndi onlar həmin adı — Ionity, Seesen, Rest Area A5 E35 Kaelberpfad, Bensheim — göründükləri hər yerdə, o cümlədən /api/v1/data/pois daxil olmaqla daşıyır. Hər məkanın id dəyəri dəyişməyib, ona görə keşlənmiş uyğunlaşdırma qüvvədə qalır; yalnız name fərqlidir.

snapshot.updated_at sahəsi /api/v1/data/queue və /api/v1/data/multi cavablarında buraxılış məntəqəsinin öz qurşağındakı yerli vaxtdır (məsələn, Europe/Istanbul, Europe/Sofia, Europe/Budapest, Europe/Warsaw, Europe/Kyiv), lakin indiyədək cavabda bunun hansı qurşaq olduğu göstərilmirdi, ona görə çağıran tərəf onu dəqiq ana çevirə bilmirdi. snapshot obyektinə əlavə timezone sahəsi (IANA adı) gəlir — updated_at ilə yanaşı. Yeni parametr yoxdur, versiya dəyişmir, digər sahələr də dəyişmir.

İndiyədək hər yanacaq son nöqtəsi öz əhatəsini əllə yazılmış siyahı ilə təsvir edirdi: AT, DE, DK, ES, FR, HR, IT, LU, PL, PT, SI, Polşa isə orada Trójmiasto bölgəsi ilə məhdudlaşdırılmışdı. Hər iki iddia çoxdan köhnəlmişdi. Əhatə artıq stansiyaların canlı indeksindən ölçülür və hər altı saatdan bir yenidən hesablanır: bu gün 39 ölkədə qiymətli stansiyalar var, onların arasında Polşa da bütün ölkə üzrə, üç şəhərdə deyil. Sorğunun özündə heç nə dəyişmir: nə parametr, nə versiya.

Nearby Fuel Stations və Cheapest Fuel: axtarış boş qayıdanda coverage bloku artıq ölçülmüş station_countries, station_counts, sparse_coverage və measured_at dəyərlərini daşıyır və bunlar ümumiyyətlə yanacağa deyil, soruşduğunuz yanacaq növünə aiddir. Ölkə sparse_coverage siyahısına orada qiymətli 25 və ya daha az stansiyamız olduqda düşür — bu, mühakimə deyil, saydır.

Tanıdığımız, lakin soruşduğunuz yerdə heç kimin qiymətləndirmədiyi növ üçün yeni qeyd var. İndiyədək coverage.fuel_type_note yalnız kolonkadakı adın özü bizə tanış olmayanda görünürdü. İndi ad düzgün tanındığı, lakin həmin ölkədə onun üçün sadəcə qiymət olmadığı halda da görünür; qeyd bu növün qiymətləndirildiyi ölkələri və ətrafınızda qiymətləndirdiyimiz növləri adlandırır. Çex adı Natural 100 təmiz nümunədir: tanınır, lakin Çexiyada heç bir mənbə ona qiymət vermir. Boş cavab artıq sınıq sorğu kimi görünmür.

Fuel Grades (/api/v2/data/fuel-grades) hər növ üçün priced_countries və priced_station_counts sahələrini əldə edir; priced_here sahəsi isə ?country= göndərdikdə əlavə olunur. İki siyahı fərqli şeylər deməkdir: countries altındakı ölkə həmin kolonka adını qəbul etdiyimiz ölkədir, priced_countries isə mənbənin onu həqiqətən qiymətləndirdiyi yerdir, ona görə də priced_here dəyərinin 0 olması cavabdakı boşluq deyil, əsl cavabdır. Cavab həmçinin coverage_measured_at və coverage_note daşıyır, Cache-Control isə yenidən hesablama tezliyinə uyğun olaraq 24 saatdan 6 saata enir.

Kolonkalardakı yerli adların daha çoxu da tanınır, onların arasında Klimadiesel 90 (HVO100) və HVO Diesel, Erdgas və Metano, Autogas və Autogaz, AdBlue üçün DEF, həmçinin premium dizel və benzinin bir sıra brend adları var. Tanınma ardıcıllığı dəyişməyib, uyğunlaşdırma dəqiq qalır, buna görə əvvəllər işləyən heç bir ad bu gün başqa məna vermir, yeni ad isə yalnız boş cavabı qiymətli cavaba çevirə bilər. Eyni zamanda istinad sənədləri və son nöqtə təsvirləri saytın hər 25 dilində düzəldildi.

Cheapest Fuel (/api/v2/data/fuel-cheapest) ən ucuz stansiyalar əvəzinə ən yaxın stansiyaları məsafə sırası ilə qaytarırdı. Sıralama nəticə sizin limit-inizə qədər kəsilməzdən əvvəl tətbiq olunduğuna görə, radiusunuzdakı ən ucuz stansiyalar cavabdan tamamilə düşə bilərdi. Sıralama artıq düzgündür: sorğuladığınız yanacaq növü üçün əvvəlcə ən ucuzu, bərabərlik halında ən yaxın stansiya qalib gəlir, həmin növ üçün qiyməti olmayan stansiya isə siyahının sonuna düşür. Sorğuda heç nə dəyişmir — nə parametr, nə versiya.

v2 yanacaq cavabları da faktiki olaraq necə ötürüldüyü kimi sənədləşdirilib: stansiyalar data.stations[] altında gəlir, hər fiziki stansiya üçün bir qeyd, hər növ prices obyektinin daxilində yerləşdirilib (price, currency, local_name, updated_at, age_hours, stale), bundan əlavə station_ref, grades, total_found və notices. Nearby Fuel Stations və Cheapest Fuel üçün istinad sənədi hələ də köhnə düz data.data[] sətir siyahısını təsvir edirdi.

Ödəniş səhifəsində (aylıq bölmə) istənilən planın üzərinə, planı dəyişmədən iki əlavə mövcuddur: Əlavə proqnoz sorğuları — hər blok üçün gündə +100 proqnoz və statistika sorğusu, hər blok üçün ayda €2, ən çox 10 blok; və Əlavə ölkələr — hər vahid üçün +1 bəyan edilə bilən ölkə, hər biri ayda €2. Sayı dəyişdirdikdə heç bir məbləğ tutulmadan əvvəl dəqiq mütənasib hesablama göstərilir.

10 noyabr 2026 tarixindən etibarən hər plan müəyyən sayda bəyan edilmiş ölkəni əhatə edir: Explorer və Student 4, Starter 10, Pro və yuxarısı limitsiz. Həmin tarixdən plan üstəgəl alınmış əlavə ölkələrdən daha uzun bəyannaməni yadda saxlamaq mümkün olmayacaq; Hesab bölməsi limitinizi artıq göstərir, limiti aşan hesablar isə idarə panelində təklif görür. 10 noyabrdan əvvəl heç nə dəyişmir.

API sandbox artıq siyahıdakı hər son nöqtəni kvota sinfi ilə (Ağır / Standart) işarələyir, seçilmiş versiya üçün kvota dəyərini siz nəyisə işə salmazdan əvvəl göstərir və sorğudan sonra eyni sorğunun canlı kvotanızdan nəyə başa gələcəyini göstərir — buraya ceil(N ppids × M sub-products / 2) düsturu da daxildir; həmin düstur /multi formalı sorğular üçün istifadə edilir.

Bu, yalnız oxunuş rejimində bir önizləmədir: sandbox sorğularının özü ayrıca sandbox test büdcənizdən çıxılır, heç vaxt canlı kvotanızdan deyil.

Bu gündən etibarən istifadədən çıxarılacağını açıq şəkildə elan etdiyimiz hər şey elan tarixində və ya ondan sonra yaradılmış tərtibatçı hesabları üçün bağlıdır. Hesabınız elandan əvvəl mövcud olubsa, heç nə dəyişmir — onu elan edən qeyddə göstərilən çıxarılma tarixinə qədər tam güzəşt müddətini saxlayırsınız.

Bu qayda nə üçün var. 24 avqust 2026-cı ildə truck-bans v1-in 8 sentyabr 2026-cı ildə istifadədən çıxarılacağını elan etdik. Həmin elandan bir neçə gün sonra iki hesab qeydiyyatdan keçdi, inteqrasiyasını v1 üzərində qurdu və bizim heç bir məktubumuz onlara çatmadan 410 cavabına saatlar qalmış vəziyyətə düşdü: həm elan, həm də bildiriş göndərişi onların qeydiyyatından əvvələ düşürdü. API-də heç nə onlara artıq aradan qaldırılacağını dediyimiz versiyanı götürməyə mane olmadı. Bu bizim səhvimiz idi və bu, onun düzəlişidir — silinməsi artıq planlaşdırılmış bir şeyi yenidən tətbiq etmək mümkün deyil.

Bu necə görünür. Belə sorğu 410 Gone və version_closed_to_new_accounts xəta kodu ilə rədd edilir. Mesajda çıxarılma tarixi, elan tarixi və əvəzinə istifadə ediləcək versiya göstərilir. Bu, qəsdən version_sunset kodundan fərqlidir; sonuncunu çıxarılma tarixinin özü keçdikdən sonra bütün hesablar alır — beləliklə dəstək xidməti jurnala baxmadan «başlamaq üçün çox gec gəldiniz» halını «bu, hamı üçün silinib» halından ayıra bilir.

Güzəşt hesabın yaradılma tarixinə görə verilir, ilk sorğuya görə yox. Elandan əvvəl qeydiyyatdan keçmisinizsə, lakin inteqrasiyaya yalnız indi başlayırsınızsa, yenə də tam güzəşt müddətini alırsınız: ola bilsin ki, siz əvvəldən onun üzərində işləyirdiniz.

İndi qüvvədədir — truck-bans v1 üçün (24 avqust 2026-cı ildə elan edilib, 8 sentyabr 2026-cı ildə çıxarılır) və bundan sonra elan edəcəyimiz hər bir çıxarılma üçün avtomatik olaraq. Sizdən yeni heç nə tələb olunmur: çıxarılan versiyaya verilən hər cavab artıq Deprecation, Sunset və Link: rel="successor-version" başlıqlarını daşıyır, buna görə yeni inteqrasiya bu səhifəni oxumadan yaxınlaşan çıxarılmanı görə bilər.

Dünənki v4 dəyişikliyinin davamı (tərtibatçı müraciəti #105). v1 və v2-də vergüllə ayrılmış destination siyahıları işləməyə davam edir, lakin artıq destination=all ilə eyni müddətə tabedir: hər ikisi 2026-10-06 tarixində dayanır (o vaxta qədər Deprecation/Sunset başlıqları, sonra isə 400 destination_list_removed, əvəzedici kimi /api/v4/ göstərilir). Vergüllü siyahılar üçün mövcud 10 element limiti yoxlaması həmin tarixə qədər dəyişmir.

v4 hər sorğuda bir təyinat nöqtəsi qaydasında qalır — bu gün bu dəyişmədi. Dəyişən yalnız v1/v2 barədə mesajdır: destination=all üçün qaytarılan 400 xətası artıq miqrasiya yolu kimi vergüllü siyahı təklif etmir (o da eyni tarixdə sonlanardı), birbaşa v4-ə yönləndirir.

Sənəd düzəlişi: bu saytdakı v4 nümunəsi əvvəllər /api/v4/data/border/1/2,3,4/9 şəklində idi — bu, v4-ün rədd etdiyi vergüllü siyahıdır. İndi o, /api/v4/data/border/1/2/9 kimidir. Köhnə nümunəni kopyalayan hər kəs ilk sorğusunda 400 alardı; üzr istəyirik.

Yeni tərcümə edilmiş açar product_border_v4_p_destination saytın hər 25 dilində yayımlanır və v1/v2 ifadəsinə qayıtmaq əvəzinə v4-ün bir təyinat qaydasını açıq şəkildə bildirir.

/api/v4/data/border/{origin}/{destination}/{crossing_type} bu gün istifadəyə verildi. v2 ilə müqayisədə üç şey dəyişir və məhz buna görə bu, düzəliş yox, yeni versiyadır.

1. destination=all artıq yoxdur. Məlumatlarımız ölkə üzrə lisenziyalaşdırılır (Developer API Terms, bölmə 7) və "məlumatına sahib olduğumuz hər qonşu" kimi genişlənən joker simvol hesabınız üçün təsdiqlənməmiş ola bilən ölkələri qaytarır — üstəlik sorğuda bunu göstərən heç nə olmur. v4-də ölkəni özünüz adlandırırsınız.

2. Hər sorğuda bir təyinat ölkəsi. /api/v4/data/border/1/2/9 bir sərhəd üçün sorğudur. Vergüllə ayrılmış siyahılar qəbul edilmir: 1/2/9, 1/3/9 və 1/4/9 sorğularını ayrıca göndərin. Vergüllü siyahı və ya all 400 qaytarır və göndərilməli olan dəqiq sorğuları adlandırır, ona görə heç nə səssizcə uğursuz olmur.

3. Bir yük nəqliyyatı kodu. v1 və v2 yük daşımalarını 8 (Freight Transport) və 9 (7,5 t-a qədər Freight Transport) kimi iki yerə bölürdü. Bu bölgü sərhəddə real mövcuddur, lakin heç bir inteqrator ona əsaslana bilmir: UA-PL sərhədində v2-dən 9 istənildikdə 70 yük keçidindən 21-i qaytarılırdı və bu barədə heç nə deyilmirdi. v4 9 sorğusuna bütün yük zolaqları ilə cavab verir, həmçinin 8 kodunu 9 üçün alias kimi qəbul edir. Hər sətir öz crossing_type dəyərini daşıyır, ona görə birləşdirilmiş cavab da yoxlanıla bilən qalır.

v1 və v2-də destination=all 2026-10-06 tarixinədək işləməyə davam edir və o vaxta qədər Deprecation / Sunset başlıqları ilə gəlir. Həmin tarixdən etibarən bu versiyalar da all üçün 400 qaytarır — v1 və v2-nin qalan hissəsi toxunulmadan qalır və əlçatan olaraq davam edir. Eyni tarix digər bütün-ölkə qısayollarına da aiddir: travel-matrix — ?dest= olmadan, bus-carriers — ?ppid=all ilə və fuel-grades — ?country= olmadan.

Bu gün əvvəl elan edilmiş v3 v4 ilə əvəz olunur. v3 v4-dən yalnız vergüllü siyahını hələ də qəbul etməsi ilə fərqlənirdi və heç bir inteqrasiya bu formadan istifadə etmir. v3 ünvanları cavab verməyə davam edir, ona görə onlara əsaslanan heç nə sınmır, lakin v3 sənədləşdirilmir və bundan sonra inkişaf etdirilməyəcək — v4-ə keçin.

v4-də qalan hər şey v2-dəki kimidir: istiqamətli yol sırası, direction{from,to}, stale və ?max_age_min=.

Yol şablonundakı rəqəmli id-lər — /border/{origin}/{destination}/{crossing_type} — heç vaxt cədvəl şəklində dərc edilməmişdi, ona görə inteqratorlar onları saat qurşaqlarından və nümunə ünvanlardan bərpa edirdilər. İndi onlar sənədlərdə Ölkə və nəqliyyat növü kodları bölməsindədir və API-nin yoxlama apardığı eyni cədvəllərdən render olunur — hər ölkə id-si onun genişləndiyi sərhədlərlə birlikdə, hər crossing_type isə API-nin qaytardığı etiketlə birlikdə.

Onları dərc edərkən aşkar etdik ki, sandbox və endpoint metadatası 8 kodunu "truck<7.5t", 9 kodunu isə "truck" kimi təsvir edir. Bu, tərsinədir: API 8 kodunu Freight Transport, 9 kodunu isə 7,5 tona qədər Freight Transport kimi etiketləyir və həmişə belə olub. Əgər yük nəqliyyatı kodunu parametr ipucundan seçmisinizsə, nəzərdə tutduğunuzun əksi olan zolağı filtrləyirdiniz. Hər yerdə düzəldildi, v3 isə bu seçimi tamamilə aradan qaldırır.

API Şərtləri v1.1 v1.0-ı qüvvəyə minməmişdən əvvəl əvəz edir və 2026-10-06 tarixindən tətbiq olunur. Zəhmət olmasa onları idarə panelinizdə qəbul edin.

Bölmə 7 artıq Market-in nə olduğunu deyir: bu, məlumatlarından istifadə etdiyiniz ölkədir — sorğu etdiyiniz keçid məntəqəsinin və ya sərhədin yerləşdiyi ölkə — istifadəçilərinizin yaşadığı ölkə deyil. İdarə panelimiz müxtəlif yerlərdə hər iki variantı yazmışdı; tətbiq isə həmişə birincini nəzərdə tuturdu.

Sizin xeyrinizə iki dəyişiklik. Hesabınız üçün artıq təsdiqlənmiş ölkələr sonrakı dəyişiklik baxışda olduğu müddətdə də istifadəyə yararlı qalır (yeni ölkə əlavə etmək artıq mövcud olanları dayandırmır). Əgər market bəyannaməsinə 5 iş günü ərzində cavab verməmişiksə, cavab verənədək tam plan limitləriniz qüvvədə qalır.

Bölmə 10.3 artıq idarə panelinin real tələb etdiyi ilə üst-üstə düşür, bölmə 13.2 isə ölçdüyümüz və sizə göstərə biləcəyimiz əlçatanlıq bazasını müəyyən edir.

Üç məhsul artıq additiv data_quality sahəsini daşıyır (high və ya low) — bu, ölçmənin real müşahidə, yoxsa həmin keçiddə canlı sayma mənbəyi olmayan model qiymətləndirməsi olduğunu göstərir: queue (yuxarı səviyyəli snapshot üzərində və data[] içindəki hər tarixi sətirdə — proqnoz sətirlərində yoxdur), update-info (zərfdə) və multi (hər keçid məntəqəsi üçün həm queue, həm də update_info alt obyektlərində). Bu, yeni siqnal deyil — bayraq daxildə artıq mövcud idi — lakin heç vaxt açıqlanmırdı, ona görə tamamilə modelləşdirilmiş keçid məntəqəsi birbaşa ölçülənlə eyni görünürdü. is_realtime bilərəkdən dəyişdirilməyib: modelləşdirilmiş sətirlər üçün hələ də true qaytarır və bu mənanın dəyişdirilməsi v2 səviyyəsində uyğunluğu pozan dəyişiklik olardı, biz burada bunu etmirik.

Həmçinin bu buraxılışdan: queue-advanced məhsulu artıq xam hava məlumatını yenidən paylamır. weather_main, temperature və wind_speed törəmə condition_code (0–5 təhlükə şkalası, hava məlumatı olmadıqda null), condition və severity ilə əvəz olunub.

2026-08-30 tarixindən bir /api/v1/data/multi sorğusu ən çox 5 sərhəd buraxılış məntəqəsi üçün cavablandırılır. Daha çox PPID sadalayan çağırış rədd edilmir: o, yenə də 200 qaytarır, lakin yalnız ?ppids= daxilindəki ilk 5 ID cavablandırılır. Qalan ID-lər nəzərə alınmır, meta.ppid_cap.ignored daxilində geri qaytarılır və kvotanızdan çıxılmır — çağırış real olaraq qaytardığına görə hesablanır.

Çağırış limiti aşdığı müddətdə cavabda X-Devapi-Warning: multi_ppid_cap başlığı və meta.ppid_cap bloku olur; blokda cap, enforced_from, enforced, ppids_asked, ppids_answered və ignored[] sahələri yer alır. 2026-08-30 tarixinədək bu sahələr enforced: false dəyəri və nəticələrin tam dəsti ilə görünür, beləliklə yaxınlaşan dəyişikliyi öz jurnallarınızda görə bilərsiniz.

Kvotanın yarıya endirimi dəyişməz qalır. Sərhəd məntəqələrinizi 5-lik qruplara bölün və adi yeniləmə dövrünüzdə hər qrup üçün bir çağırış göndərin; yalnız növbənin uzunluğunu və məlumatın təzəliyini tez-tez soruşmaq üçün update-info standart sinfin daha ucuz məhsulu olaraq qalır.

Ukrayna üçün hesablanan istilik qadağası — include_ua_heat ilə, country=UA sorğularında isə avtomatik qaytarılır — artıq istədiyiniz tarix aralığı üçün cavab verir. Əvvəllər date_from və date_to nə deyirsə desin, növbəti yeddi günü qaytarırdı; buna görə dekabr aralığı üçün səssizcə bu həftənin sətirləri gəlirdi. Qadağa qadağa təqvimindən oxunmur, hava proqnozundan hesablanır, ona görə də təqvimdə olmayan iki hüdudu var: geriyə baxmır və proqnoz harada bitirsə orada bitir. Aralığınız artıq proqnozun həqiqətən əhatə etdiyi dövrlə kəsişir və yeni ua_heat_ban.forecast_horizon sahəsi əlçatan son tarixi göstərir. Bu üfüqdən kənar aralıq heç bir sətir qaytarmır və səbəbini summary daxilində izah edir — bu «qadağa yoxdur» demək deyil. v1 cavabları dəyişməyib.

Cavabın forması indiyədək heç yerdə sənədləşdirilməmişdi: məhsulun nə qaytardığını öyrənməyin yeganə yolu onu çağırmaq idi. İndi hər məhsul səhifəsində, parametrlər cədvəlinin altında bir cədvəl var: Cavab sahələri hər sahənin qısa təsviri ilə; siyahı elementlərinin sahələri belə göstərilir: items[].name, zərf səviyyəsindəki sahələr (usage, meta, snapshot, resolved_location) isə önsüz. 42 məhsuldan 40-ı sənədləşdirilib: hələ işə salınmamış ikisi (weather, road-quality) bilərəkdən təsvirsiz qalır. Eyni cədvəl GitHub-dakı açıq sənədləşmə güzgümüzdə də dərc olunur.

Artıq hər yanacaq məhsulu yalnız bizim daxili yazılışımızı deyil, yanacağın yerli adını da qəbul edir: ON Polşada, Nafta Çexiyada, Gázolaj Macarıstanda, Motorină Rumıniyada, ДП Ukraynada, Motorin Türkiyədə, Gasóleo Portuqaliya və İspaniyada. Ad ilk növbədə ölkəyə görə müəyyən olunur — “95” Danimarka kolonkasında E10, Polşa kolonkasında isə E5 deməkdir — ona görə country parametrini yerli adla birlikdə və ya nöqtəni yerləşdirə biləcəyimiz koordinatları göndərin. Cavabda fuel_type (kanonik), fuel_type_requested (yazdığınız kimi) və fuel_type_local qaytarılır. Yerləşdirə bilmədiyimiz adı heç vaxt standart yanacaqla əvəz etmirik: cavab boş gəlir və bunu açıq deyir.

Cədvəlin tamamı artıq ayrıca məhsuldur — GET /api/v2/data/fuel-grades[?country=PL][&fuel_type=ON] — kanonik yanacaqlarımız və onların Avropanın 41 ölkəsindəki yerli adları, qiymət vermədiyimiz bazarlar da daxil olmaqla. Bundan əlavə, fuel və fuel-local məhsullarının ölkə və region səviyyələri grades obyekti qazandı: o, hər qiymət açarını yanacağa və onun kolonkadakı adına bağlayır.

Artıq truck-bans məhsulu aşağıdakı ünvanda konkret tarix və ya tarix aralığı üzrə cavab verir: /api/v2/data/truck-bans. İndiyədək o həmişə növbəti 7 günü qaytarır və göndərilən tarixi nəzərə almırdı, buna görə təqvim qurmaq üçün hər günə bir sorğu lazım gəlirdi — saniyədə iki sorğu verən planda isə onların əksəriyyəti bu xəta ilə rədd edilir: 429 qps_exceeded.

Bir gün üçün ?date=YYYY-MM-DD parametrindən, aralıq üçün ?date_from= və ?date_to= parametrlərindən istifadə edin. Hər iki hədd daxildir və istənilənini buraxmaq olar: başlanğıc susmaya görə bugünkü gündür, son isə başlanğıc üstəgəl 7 gündür. Pəncərə ən çoxu 92 günü əhatə edə bilər — daha uzunu səssizcə kəsilmək əvəzinə bu xəta ilə rədd edilir: 400 date_range_too_long. Bu, gələcəyə yönəlmiş təqvimdir: pəncərə ən çoxu 7 gün əvvəldən başlaya bilər, daha köhnə tarixlər təqdim edilmək əvəzinə rədd edilir — əhatə irəliyə doğru 31 dekabr 2028-ci ilədək, 23 ölkədə davam edir.

Hər cavab artıq əhatə olunan dəqiq aralığı bildirən window obyektini daşıyır. Bu əlavə sahədir və v1-də də göndərilir; v1 isə sabit 7 günlük pəncərəsini dəyişmədən saxlayır. Nəzərə alın: include_ua_heat hansı pəncərəni istəməyinizdən asılı olmayaraq həmişə növbəti 7 günü əhatə edir — o, qadağa təqvimindən deyil, hava proqnozundan hesablanır. Xatırladırıq ki, bu məhsulun v1 versiyası 8 sentyabr 2026-cı ildə dayandırılır.

Bütün API üzrə iki əlaqəli təkmilləşdirmə: məhsulun qəbul etmədiyi hər parametr artıq səssizcə atılmaq əvəzinə cavabdakı ignored_params sahəsində sadalanır, məlumat xidmətindən gələn yoxlama xətaları isə sizə yazıldığı kimi çatır, maşınla oxunan kod isə bu sahədədir: error.reason.

Şlüz auditindən (bilet #43) irəli gələn üç cavab keyfiyyəti düzəlişi.

X-API-Key başlığı artıq qəbul edilir — Authorization: Bearer və ?key= ilə yanaşı. Əgər HTTP klientiniz açarları X-API-Key adlı başlıq vasitəsilə göndərirsə, bu artıq işləyir — əvvəllər o, səssizcə nəzərə alınmır və sorğu missing_api_key kimi rədd edilirdi. Authorization: Bearer sənədləşdirilmiş və tövsiyə olunan forma olaraq qalır.

Çatışmayan açar xətasının mesajı artıq autentifikasiyanın hər üç üsulunu adlandırır (Bearer başlığı, X-API-Key başlığı və ya ?key=) — yalnız qeydiyyat səhifəsinə keçid vermək əvəzinə.

checkpoints kataloqu artıq hər sətirdə has_day_stats daşıyır — bu, Best Time to Cross (day-stats) API-nin həmin buraxılış məntəqəsi üçün məlumatı olub-olmadığını bildirən əlavə məntiqi sahədir. Day-stats yalnız monitorinq edilən buraxılış məntəqələrinin bir hissəsi üçün mövcuddur; proqnozlaşdırıla bilən 404-lərdən qaçmaq üçün sorğu göndərməzdən əvvəl bu bayrağı yoxlayın. Mövcud sahələr dəyişməyib.

Sənədlərdə daha bir düzəliş: road-conditions məhsulu etiketlərin lokallaşdırılması üçün lang parametrini həmişə nəzərə alıb — sadəcə siyahıda göstərilməmişdi.

truck-bans məhsulu üçün iki düzəliş və bir yeni versiya.

Vergüllə ayrılmış ölkələr artıq işləyir. ?country= 3-ə qədər ISO-2 kodundan ibarət siyahını qəbul edir, məsələn ?country=DE,RO. Daha uzun siyahı səssizcə kəsilmir, 400 too_many_countries ilə rədd edilir — bu, ölkə üzrə qadağa təqvimidir, kütləvi məlumat axını deyil. Əvvəllər bu işləmirdi: ayırıcı silinirdi, buna görə DE,RO tək bir DERO tokeni kimi oxunur, heç nə ilə uyğun gəlmir və success: true ilə total_bans: 0 qaytarırdı — birlikdə 22 qadağası olan iki ölkə üçün inamlı “qadağa yoxdur” cavabı. Əgər bunu hər ölkə üçün ayrıca sorğu göndərməklə keçmisinizsə, indi tək sorğu hamısını əhatə edir və bir neçəsi əvəzinə bir çağırışa başa gəlir.

Cavablar artıq öz tamlığını bildirir. Üç əlavə sahə — returned, total_available və truncated — cavabın məhdudlaşdırılıb-məhdudlaşdırılmadığını göstərir. Xüsusilə, əhatəsi göstərilməyən sorğu kəsilmiş hissə qaytarır və indiyədək cavabın içində bunu bildirən heç nə yox idi. total_bans mövcud mənasını saxlayır (bu cavabdakı sətirlər), ona görə də artıq emal etdiyiniz heç nə dəyişmir.

v2 ölkə üzrə əhatələnib. /api/v2/data/truck-bans ünvanında ?country= tələb olunur və əhatəsi göstərilməyən sorğu 400 scope_required ilə rədd edilir — bu məhsul ölkə üzrə qadağa təqvimidir, kütləvi məlumat axını deyil. v1 bu gün dəyişməyib — o hələ də əhatəsiz sorğunu qəbul edir və həmişəki kimi eyni məhdudlaşdırılmış 50 sətri qaytarır, ona görə də işlək olan heç nəyiniz indi sınmır. Bu məhsulun v1 versiyası 8 sentyabr 2026-cı ildə istismardan çıxarılır. O, 7 sentyabra qədər normal işləyir; 8 sentyabrdan v1 sorğusu 410 Gone və v2-yə yönləndirən mesajla rədd edilir. O vaxta qədər hər v1 cavabı Deprecation: true, həmin tarixi göstərən Sunset başlığı və varis versiyanı adlandıran Link başlığı daşıyır ki, klient kitabxanası bu səhifəni heç kim oxumadan son tarixi göstərə bilsin. Miqrasiya üçün: versiya seqmentini /api/v2/data/truck-bans olaraq dəyişin və ?country= ötürün.

Sənədlərdə bir düzəliş: date parametri silindi. O, uzun müddət siyahıda idi, lakin xidmət tərəfindən heç vaxt oxunmurdu, buna görə onu göndərən istənilən sorğu istədiyi gün əvəzinə səssizcə standart 7 günlük pəncərəni alırdı. Gün seçmək üçün upcoming_bans massivini onun date sahəsinə görə süzün. Həmçinin DEU kimi ISO-3 kod artıq xülasədə ölkə adına çevrilmir — orada o, çaşdırıcı “No truck ban data for: Germany.” mesajını yaradırdı.

truck-bans məhsulu indi daha beş ölkə üzrə ölkədaxili hərəkət məhdudiyyətlərini qaytarır: Belçika (BE), Belarus (BY), Monteneqro (ME), Şimali Makedoniya (MK) və İsveç (SE). Bolqarıstan, Yunanıstan və Portuqaliya üzrə mövcud əhatə genişləndirilib və yenilənib — Yunanıstan məhdudiyyətləri artıq 2027-ci ilin sentyabrına qədər uzanır, Portuqaliya isə yenidən məlumatla doldurulub.

Cavabın strukturu dəyişməyib. Yeni sətirlər digər bütün qadağalarla eyni açarları daşıyır: date, time_from, time_until, restriction_type, restriction_details, min_weight_tons və details_url. Məhdudiyyət yalnız müəyyən şərt daxilində qüvvədədirsə — məsələn, Belarusdakı yay qadağaları 25 °C-dən yuxarı temperaturda tətbiq olunur — bu şərt restriction_details sahəsində göstərilir, ona görə sürücünü xəbərdar etməzdən əvvəl bu sahəni oxuyun. Qayda tonaja deyil, daşıma sinfinə (təhlükəli yüklər) aiddirsə, min_weight_tons dəyəri null olur.

fuel-stations və fuel-cheapest məhsulları indi Polşada məntəqə səviyyəsində qiymətlər qaytarır. Əhatə qismidir — Üçşəhər bölgəsi (Qdansk, Qdınya, Sopot) — buna görə Polşa yeni, əlavə coverage.sparse_coverage massivində, mövcud coverage.station_countries siyahısının yanında göstərilir. sparse_coverage siyahısındakı ölkədə məntəqə məlumatları ərazisinin yalnız bir hissəsi üçün mövcuddur; həmin ölkənin başqa yerindən edilən sorğu əvvəlki kimi əhatə qeydi ilə birlikdə boş siyahı qaytarır. Polşa qiymətləri PLN ilə verilir.

Kütləvi sorğu xətası da daha aydındır: lat olmadıqda scope_required mesajı artıq ölkə üzrə orta qiymətlər üçün fuel məhsuluna (?country=XX) yönləndirir.

GET /api/v2/data/fuel-local?lat=&lon= indi qiyməti iki əvəzinə üç səviyyədə həll edir: station, sonra region, sonra country. Yeni ara səviyyə ayrı-ayrı məntəqələr üzrə qiymətin heç yerdə olmadığı Ukrayna üçün mövcuddur: Ukraynadakı nöqtə artıq ölkə ortalaması əvəzinə öz vilayətinin orta qiymətini alır və yalnız vilayət üçün kotirovka olmadıqda ölkə ortalamasına qayıdır.

region səviyyəsindən gələn cavab vilayət kodunu (ISO 3166-2 dəyəri, məsələn UA-46), region_name və region_center_dist_km sahələrini, həmçinin ölkə səviyyəsi ilə eyni qiymət açarlarını daşıyır. Kodu əvvəlki kimi resolution sahəsinə görə budaqlandırın, cavabın formasına görə yox; station və country cavabları dəyişməyib.

Yeni GET /api/v2/data/fuel-local?lat=&lon= son nöqtəsi Avropanın istənilən nöqtəsi üçün mövcud ən yaxşı yanacaq qiymətini qaytarır. Məntəqələr üzrə məlumatımızın olduğu yerlərdə ən yaxın məntəqələrin qiymətləri ilə, əks halda nöqtənin yerləşdiyi ölkənin orta qiyməti ilə cavab verir — ayrı-ayrı məntəqələr üzrə qiymətin heç yerdə olmadığı Ukrayna daxil olmaqla.

Hər cavabda cavab verən səviyyəni göstərən resolution sahəsi var: station (hər biri öz valyutasında, distance_km ilə birlikdə məntəqələr siyahısı) və ya country (ölkə üzrə orta qiymətləri olan bir obyekt). Kodu cavabın formasına görə deyil, resolution sahəsinə görə budaqlandırın. /api/v2/ versiyasından etibarən mövcuddur; fuel, fuel-stations və fuel-cheapest dəyişməyib.

fuel-stations və fuel-cheapest məhsulları indi Almaniyada xeyli çox məntəqəni əhatə edir, qiymətlər isə gün ərzində yenilənir — kənd yerləri də daxil olmaqla. fuel_type parametri 13 yanacaq növünü qəbul edir: diesel, e5, e10, superplus, super100, premdiesel, truckdiesel, hvo, lpg, cng, adblue, e85 və lng. Sorğuya heç bir məntəqə uyğun gəlmədikdə cavaba məntəqə məlumatı olan ölkələrin siyahısını göstərən coverage obyekti əlavə olunur.

radius= parametri artıq onu sənədləşdirən bütün məhsullarda radius_km üçün uyğun alias kimi qəbul edilir. fuel-stations və fuel-cheapest məhsulları uyğun məntəqə tapılmadıqda səssizcə boş nəticə əvəzinə əlavə coverage obyekti qaytarır (məntəqələri olan ölkələrin siyahısı və qeyd). route-plan məhsulunun sərhəd obyektləri indi əlavə wait_basis açarını ehtiva edir (car_lane yoxsa vehicle_lane), beləliklə müştərilər yük maşınları üçün gözləmə məlumatının əslində minik avtomobili zolağından götürüldüyünü bilirlər. Marşrut boyunca yük maşınları üçün sərhəd keçidlərinin uyğunlaşdırılması nəzərəçarpacaq dərəcədə dəqiqləşib: yük zolağı məlumatı olmayan keçid cütləri üçün minik zolağından ehtiyat məlumat, yanlış istiqamətdən qoruma, daha ciddi məsafə həddi və eyni mövqedəki keçidlərin təkrarlarının silinməsi. Bütün dəyişikliklər əlavə xarakterlidir, uyğunluğu pozan dəyişiklik yoxdur.

Tərtibatçılar üçün giriş səhifəsində indi keçid naviqasiyası ilə lövbərlənmiş bölmələr var (#products, #plans, #quickstart, #integrations, #datasets, #apps, #companies, #showcase) və hər məhsul kartı öz sənədləşdirmə səhifəsinə keçid verir. Yeni Mobile apps bölməsi Kordon Online və Truck Bans-ı Google Play keçidləri ilə təqdim edir. Tərcümə tamamlanması: ödəniş tarixçəsi, giriş xətaları, sandbox keçidləri və plan seçim düyməsi indi bütün 25 dildə lokallaşdırılıb.

Fleet beacon cavabı (POST /api/v1/fleet_position.php) indi sahibdən→sürücüyə gözləyən mesajları çatdıran messages massivini əhatə edir. Yalnız sahiblər üçün yeni canlı JSON axını (?ajax=live) və flot panelində "Sürücülərə mesajlar" kartı. Sürücü dəvəti üçün yeni səhifə /{lang}/get-nakbus (25 dil).

product_fleet_vehicles/live/history üçün title, desc və fleet-history parametrləri tərtibatçı portalının bütün 25 dilində lokallaşdırıldı.

/api/v1/data/truck-bans indi cavabı hansı sorğunun yaratmasından asılı olmayaraq eyni üst səviyyəli sahələr toplusunu qaytarır. Əvvəllər təqvim qadağaları olmayan ölkə üçün sorğu, tanınmayan ppid və ya adi verilənlər bazası uyğunluğu hər biri fərqli sahələri (məs. country, covered_countries, ppid) buraxa bilərdi. İndi hər cavab ardıcıl olaraq 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 və upcoming_bans sahələrini əhatə edir (aid olmadıqda null və ya boş), bu da müştəri tərəfində təhlili sadələşdirir.

Hər xidmət üzrə doqquz yeni məhsul. Məkana əsaslananlar lat/lon və ya city + country qəbul edir (şəhəri sizin üçün özümüz geokodlaşdırırıq): /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 (yanacaq növü üzrə qiymətə görə sıralanmış stansiyalar) və /api/v2/data/internet-points; nəticələr distance_km daşıyır və radius ilə məhdudlaşdırılır. /api/v2/data/vignettes ölkənin vinyet tələb edib-etmədiyinə cari qiymətlərlə cavab verir. Mövcud pois məhsulu artıq sənədləşdirildiyi kimi lon və radius-u dəstəkləyir, fuel məhsulunun mode=nearest rejimi də lon-u qəbul edir. Doqquzunun hamısı sandbox-da mövcuddur.

/api/v1/data/truck-bans-dakı hər qadağa artıq restriction_type (General / Local / Sunday / Holiday / Seasonal), restriction_details (təsirlənən dəqiq əhatə və ya yollar) və min_weight_tons daxildir. details_url indi nakordoni.eu saytında ölkəyə görə səhifələrə yönləndirir. Yeni ixtiyari lang parametri ölkə adlarının və xülasənin dilini seçir; defolt indi ingilis dilidir.

Yanlış ?ppid= indi qısa "Request failed" əvəzinə əsl səbəbi qaytarır: xəta parametri, gözlənilən id_<number> formatını adlandırır və /api/v1/data/checkpoints ünvanına yönləndirir. stats, forecast, update-info, weather və bus-carriers parametr cədvəlləri artıq id_13 nümunəsini bütün 25 dildə göstərir.

Portalın yenilənmiş interfeysi (yuxarı zolaq, ikonlu yan panel, KPI paneli, kart əsaslı düzülüş) artıq bütün daxil olmuş tərtibatçı hesabları üçün standartdır — planlaşdırılmış 10 avqust buraxılışından əvvəl. Klassik düzülüşə istənilən vaxt qayıtmaq üçün ?v=1 istifadə edin.

Tərtibatçı portalının bütün səhifələri — əsas səhifə, sənədlər, idarə paneli, AI Studio, sınaq mühiti, müraciətlər, sorğular, ixrac, avtopark, xəbərlər, dəyişikliklər jurnalı və hesab səhifələri — artıq heç bir reklam skripti və ya reklam sahəsi yükləmir. Bu, əvvəlki kimi yalnız giriş və qeydiyyat səhifələrinə deyil, bütün portala aiddir.

Bütün sərhəd səfərini bir sorğu ilə planlaşdırın: /api/v2/data/route-plan marşrutu, onun üzərində həqiqətən yerləşən keçid məntəqələrini canlı növbə və ya gəliş vaxtınıza proqnozla, həmçinin sürücünün həqiqətən etdiyi dayanacaqları — istirahət, yemək, yanacaq — vahid zaman xəttində qaytarır.

Sərhəd həmin xəttin bir hissəsidir. Uzun növbə onsuz da çatmış fasilə kimi sayılır və sükan arxasındakı vaxtı sıfırlayır, ona görə üç saatlıq gözləmə heç vaxt üç saat plüs heç kimin etmədiyi tam fasilə dəsti kimi göstərilmir. Minik avtomobilləri üçün təhlükəsiz sürmə modeli tətbiq olunur; avtobus və yük maşınları AB 561/2006 üzrə məcburi istirahət alır, avtobusların servis vaxtı isə 1000-dən çox lisenziyalı beynəlxalq cədvəl üzərində kalibrlənib. Hər dayanacağa real istirahət zonası və ya yanacaqdoldurma məntəqəsi adı vermək üçün stop_places=1, başqa keçiddən getmək üçün via=lat,lon əlavə edin.

Portal menyusunda yenilik: Təqdimat — nakordoni məlumat platformasının canlı, həmişə aktual təqdimatı, sizin bazarınıza uyğunlaşdırılmış (sığorta, səyahət, logistika, daşıyıcılar, media, naviqasiya, yanacaq, fintex, dövlət sektoru və ya şəxsi layihələr). O, platformanın real 30 günlük həcmlərini, sizin API istifadənizi, cavab müddəti və limit statistikasını, həmçinin çağırışlarınız pulsuz səviyyənin hüdudlarına çatanda tarif tövsiyəsini göstərir. Bazarınızı (və ya bazarlarınızı) səhifədə, profilinizdə — yaxud qeydiyyat zamanı seçin və ya təsdiqləyin. İlk ziyarətdə avtomatik açılır; avtomatik açılmanı elə səhifənin özündə söndürmək olar.

Əgər assistentdə axın aktivdirsə, lakin çağırış həmin axına lazım olan konteksti gətirmirsə — məsələn, queue parametri olmadan ppid— axın artıq hər hansı sorğudan əvvəl ötürülür və hesablanmır. Əvvəllər o, yenə də çağırılır, uğursuz olur və buna baxmayaraq bir vahidə başa gəlirdi. Studiya hər axına nəyin lazım olduğunu göstərir, konteksti doldurduqca qiyməti yenidən hesablayır və nəticələri ✓ icra olundu / ⊘ ötürüldü, ödənişsiz / ✕ uğursuz kimi işarələyir; API hansı parametri ötürmək lazım olduğunu dəqiq bildirən data.feeds_skipped qaytarır.

Cavablar artıq axınları, məlumat mənbələrini və ya hər hansı texniki şeyi qeyd etmir: çatışmayan axın son istifadəçi üçün ən çoxu bir sadə cümlədir, heç vaxt daxili ad deyil. Yalnız ixtiyari filtrləri olan axınlar (məsələn, məlumatımız olmayan ölkəyə daraldılmış fuel ) artıq heç nə qaytarmaq əvəzinə geniş məlumat toplusuna qayıdır.

Yeni: /{lang}/developers/studio. Sizin məzmununuzdan və bizim canlı sərhəd məlumatlarımızdan cavab verən süni intellekt assistenti qurun. Bizə markdown fayllarınızı verin və ya sadəcə səhifələri göstərin — biz onları yükləyib indeksləyəcəyik; siz yalnız öz fayllarınızı saxlayırsınız. Onun hansı axınlarımızdan istifadə edə biləcəyini seçin (növbə, proqnoz, alternativlər, günlük statistika, yanacaq, yük maşınları üçün qadağalar, ticarət bazar günləri, bayramlar, yol vəziyyəti, avtobus daşıyıcıları, POI, valyuta), model səviyyəsini seçin (sürətli / balanslaşdırılmış / pro — qiyməti məhz o müəyyən edir), məlumatlarımızın cavabın harasına düşdüyünü dəqiq göstərən {{feed.slug}} yer tutucuları ilə öz təlimatlarınızı yazın və hər cavaba əlavə olunan öz yekun cümlənizi əlavə edin. Hazır şablonlar: şəxsi səyahət assistenti, iş/yük assistenti, sığorta və Yaşıl Kart satışı assistenti.

Onu studiyada sınayın (gündə 30 cavab, API kvotanızdan ayrı), sonra isə istehsalatda GET /api/v2/data/assistant-custom?assistant_id=N&q=…ünvanında çağırın. Bir cavabın qiyməti = model səviyyəsinin vahidləri + hər aktiv axın üçün 1 vahid, X-Devapi-Unitsbaşlığında qaytarılır. Məhsul yalnız v2-dədir — v1 URL-i unsupported_versionqaytarır. Mövcud assistant məhsulu dəyişməyib.

Hər assistent platformanın məzmun siyasəti altında işləyir və bu siyasət sizin təlimatlarınızdan üstündür: rəsmi şəxs kimi görünmək, sərhəd və ya gömrük nəzarətindən yayınmağa kömək etmək, uydurma rəqəmlər və söyüş qadağandır. Həm təlimatlar, həm də cavablar yoxlanılır; bloklanmış çağırışlar qeydə alınır.

Yenilik: https://nakordoni.eu/mcp ünvanında əsl MCP server, API-nin təhlükəsiz, yalnız oxumaq üçün olan alt dəstini (status, checkpoints, border queue, live queue, forecast) MCP alətləri kimi təqdim edir. REST API ilə eyni API açarı və kvota. Server kartı /.well-known/mcp/server-card.json ünvanında. Sənədlərdə MCP server bölməsinə baxın.

Aşağıda təsvir olunan „Live Queue & Freshness API“ adlandırması əslində sənədlər səhifəsinə çatmamışdı. Səhifə hər məhsulun başlığını tərcümə axtarışı ilə göstərir və bu axtarış son nöqtənin başlığına yalnız tərcümə olmadıqda müraciət edir — tərcümə isə artıq mövcud idi, köhnə adda donmuş halda, interfeysin bütün 25 dilində. Bundan sonra o, özü yenilənənə qədər əsas başlığın hər hansı gələcək yeniləməsindən üstün olacaq.

Tərcümə açarı bütün 25 dildə dəyişdirildi, beləliklə sənədlər səhifəsi indi uyğun gəlir. Son nöqtə, parametrlər və ya cavabda dəyişiklik yoxdur — yalnız başlıq mətni.

Canlı növbə məlumatlarını tez-tez sorğulayırsınızsa, ağır kvotanı lazımsız yerə xərcləyə bilərsiniz. /update-info standart sinifdəndir və canlı dəyəri artıq qaytarır:

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

O, bunları qaytarır: queue_now, freshness, age_minutes, is_realtime, status, timestamp və timezone. Ondan tez-tez yeniləmə üçün standart gündəlik kvotanız hesabına istifadə edin, /queue, /multi və /forecast (hamısı ağır sinif) son nöqtələrini isə wait_min, trend sahələri və ya tarixçə lazım olduqda saxlayın.

Son nöqtənin özündə heç nə dəyişməyib — yalnız sənədlərində. O, „Data Freshness API“ kimi göstərilmişdi və təsviri yalnız təzəlik qiymətindən bəhs edirdi, heç vaxt queue_nowsahəsindən deyil, ona görə də gözdən qaçırmaq asan idi. İndi adı „Live Queue & Freshness API“-dir və qaytarılan sahələr açıq şəkildə sadalanıb. Bunu qaldıran tərtibatçıya təşəkkür edirik.

Bəzi uğursuz sorğular HTTP 200 və ok: true qaytarır, xətanı isə data içində gizlədirdi — buna görə sənədləşdirilmiş if (!ok) throw şablonu onları aşkarlaya bilmirdi, çağırış isə yenə də hesablanırdı. Bu çağırışlar indi sənədlərdə göstərildiyi kimi HTTP 400 və ok: false , həmçinin düzgün error.code / error.messageqaytarır. fuel-cities məhsulunda dəstəklənməyən ölkə ilə və travel-matrix məhsulunda səhv koordinatlarla müşahidə olunub.

Ayrıca: məcburi parametr olmadıqda 500 internal_error əvəzinə 400 bad_request qaytarılırdı (daxili xidmətin 4xx cavabının gövdəsi statusu oxunmamış atılırdı). İndi daxili xidmətin mesajı ilə 400 bad_request qaytarılır — məsələn, search parametri olmadan ?name=.

Uğurlu cavablar bayt-bayt dəyişməyib — eyni sahələr, eyni parametrlər, eyni kvota dəyəri. Müştəriniz artıq oküzrə budaqlanırsa, heç nə dəyişdirməyə ehtiyac yoxdur. Əgər o, ok dəyərini nəzərə almayıb birbaşa data oxuyurdusa, indi onsuz da həmişə uğursuz olan çağırışlarda xəta zərflərini görəcək.

Səhv aradan qaldırıldı: /multi keşi soyuq olan hər dəfə bəzi keçid məntəqələri üçün — əsasən Balkan və Macarıstan–Serbiya sərhədində — səhv növbə sayı qaytara bilirdi. Ehtiyat yol həmin keçidlər üçün növbə məlumatı saxlamayan cədvəli oxuyur və əlaqəsiz dəyərləri avtomobil sayı kimi bildirirdi. Ölçülmüş nümunələr: 12 avtomobili olan məntəqə 6 bildirirdi, real növbəsi olan bir neçəsi isə 0 bildirirdi.

Sezə biləcəyiniz üç dəyişiklik:

• found: false indi növbə haqqında təzə məlumatın həqiqətən olmadığını bildirir. Əvvəllər siz uydurma found: true ilə queue_now: 0ala bilirdiniz.
• wait_status, trend_percent və trend_direction indi soyuq sorğularda da qaytarılır — əvvəllər onlar null idi.
• Son nöqtə keşdəki anlıq görüntüsü köhnəldikdə də (24 saatdan çox) ehtiyat yola keçir, yalnız o olmadıqda deyil.

Sorğu parametrlərində, kvota dəyərində və ya cavab strukturunda dəyişiklik yoxdur.

Hər /multi çağırışının iki dəfə hesablanmasına səbəb olan xəta düzəldildi — əvvəlcə ümumi 1 vahidlik yoxlama, sonra isə endpointin öz dəyişkən dəyər düsturu ilə (N PPID × alt-məhsullar). İndi çağırış sənədləşdirildiyi kimi məhz ⌈(N×M)/2⌉ vahidə başa gəlir, əlavə ödəniş olmadan.

Həmçinin sənədləşmə səhifəsində hər məhsul üçün kvota sinfi nişanı (Standard/Heavy) əlavə edildi, beləliklə bir baxışda hansı gündəlik kvotadan istifadə edildiyi aydın olur.

country və countries bir parametrə birləşdirildi (1-15 vergüllə ayrılmış kod). Yeni compare_to parametri: ölkələr arasında eyni/fərqli bayram müqayisəsi, upcoming+days ilə birlikdə işləyir. lang artıq bir neçə dili qəbul edir (bir names obyekti əlavə edir). days=0 və ya buraxılması indi upcoming rejimində limit yoxdur deməkdir.

Hər Avropa ölkəsi üzrə rəsmi dövlət bayramları — tarixlər, yerli adlar və növ. nakordoni.eu bayram təqvimi səhifəsini və proqnoz sisteminin təqvim amillərini işə salan eyni Nager.Date / OpenHolidaysAPI xidməti (yerli hesablanmış Kosovo təqvimi ilə) ilə təmin olunur.

• ?country=PL&year=2026 — bir ölkə üçün tam illik bayram siyahısı
• ?upcoming=1&days=30 — ölkələr üzrə qarşıdan gələn bayramların düz siyahısı
• Parametrsiz — hər növbəti bayramla əsas ölkə dəstinin indeksi

currency məhsulu əlavə edildi — Frankfurter (ECB) mənbəyindən götürülən və 6 saat keşlənən PLN, CZK, HUF, USD, GBP, CHF, NOK və UAH üçün EUR-əsaslı məzənnələr. Parametrsiz, həmişə tam məzənnə cədvəlini qaytarır. sənədlərə baxın.

Öz veb saytınızda canlı Avropa yük maşını hərəkət qadağalarını yerləşdirin — 3 dizayn (light, dark, board), 5 dil (en, uk, pl, de, ru), opsional ölkə üzrə filtr və canlı «indi aktiv» statusu olan pulsuz iframe vidceti. API açarı tələb olunmur. Kodu nakordoni.eu/en/for_truck_drivers/traffic_bans/widget ünvanında konfiqurasiya edin və kopyalayın. Xam məlumatı üstün tutursunuz? truck-bans API məhsulu və ictimai JSON lenti mövcud olaraq qalır.

Üç əlavə, hamısı geriyə uyğun — v1 dəyişməz qalır.

Endpoint üzrə versiyalaşdırma. İndi /api/v2/ əsas URL-i var. O, endpoint üzrədir: yalnız həqiqətən dəyişmiş endpointlər v2 altında fərqli davranır; hər digər endpoint şəffaf şəkildə öz v1 cavabını verir (belə ki, /api/v2/data/queue = v1 ilə eyni məlumat, sadəcə "api_version":"v2" ilə). İşləyən endpointləri köçürməyə ehtiyac yoxdur.

border v2 istiqamətlidir. Yol sırası səyahət istiqamətidir:

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)

Hər keçid məntəqəsi həmçinin bir direction {from,to} obyekti və stale boolean dəyəri qazanır və ?max_age_min=N yalnız son vaxtlar yenilənmiş keçidləri qaytarır. (v1 border sıradan asılı olmayaraq hələ də sərhədin hər iki tərəfini qaytarır — dəyişməz.)

İnteraktiv Sandbox. Daxil olmuş developerlər indi brauzerdən istənilən endpointi Developers → Sandbox ünvanında sınaya bilər — bir endpoint, versiya və açarlarınızdan birini seçin, parametrləri tənzimləyin və canlı cavabı görün. Sandbox testinin öz ayrıca gündəlik büdcəsi var (gündə 50 çağırış) və heç vaxt canlı API kvotanıza toxunmur.

Sənədlər indi endpoint üzrə bölünüb (Developers → API Docs) və birdən çox versiyası olan endpointlərdə versiya seçicisi var.

Mövcud section_mode və hava tənzimləmələri ilə yanaşı gözləmə vaxtı formuluna iki yeni amil əlavə edildi:

• service_rate — hazırda emal edilən ölçülmüş maşın/dəq göstəricisinin keçid məntəqəsinin konfiqurasiya edilmiş baza sürəti ilə nisbəti. Multiplikativ, 0.5x-1.5x ilə məhdudlaşdırılıb.
• shift_change — keçid məntəqəsinin öz yerli 08:00/20:00 sərhədçi növbə dəyişikliyinin təsiri. Additiv (dəqiqə), multiplikativ deyil — yalnız növbədən +/-60 dəqiqə ərzində tətbiq olunur, minimum nümunə tarixçəsi tələb edir, +/-120 dəqiqə ilə məhdudlaşdırılıb.

advanced_wait_min indi round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min-dir. Hər iki amil həmçinin tarixi müqayisələr üçün driver_reported.prognosed_advanced_wait_min-də əks olunur.

Təhlükəsizlik/məxfilik yoxlamasının bir hissəsi olaraq aşağıdakı sahələr silindi — onlar heç bir real məhsul dəyəri olmadan daxili tətbiq detallarını (yuxarı axın məlumat mənbəyi taksonomiyamız, DB sətir ID-ləri, daxili pipeline qeydləri, istifadə olunmayan/ölü sahələr) açıqlayırdı:

• id və corrected — queue sətir obyektlərindən silindi
• source (xam sətir, məs. "line") — queue, multi və update-info-dan silindi. update-info və multi-nin update_info bloku hələ də source_category/source_label_en daşıyır (kiçik ictimai lüğət); queue və multi-nin queue bloku artıq heç bir source sahəsi daşımır
• traffic_status — border-dən silindi; o həmişə null idi və sistemin heç bir hissəsi tərəfindən doldurulmurdu

İnteqrasiyanız bu sahələrdən hər hansını oxuyursa, zəhmət olmasa yeniləyin — cari sahə siyahısını müvafiq məhsulun sənəd səhifəsində görün.

Gündəlik kvota istifadəsi (hər cavabda usage.used) indi həmişə tam ədəd əvəzinə onluq dəyər (məs. 67.5) ola bilər. Bu, queue-advanced-in kəsr tariflə hesablanmasının yan təsiridir — aşağıya baxın. usage.limit təsirlənmir və həmişə tam ədəddir. Müştəriniz usage.used-i ciddi şəkildə tam ədəd kimi tiplənirsə, zəhmət olmasa onu onluq/float qəbul edəcək şəkildə genişləndirin.

Bu üç məhsul indi veb saytın göstərdiyi eyni canlı status sahələrini qaytarır: wait_status (green/yellow/red, bu keçid məntəqəsinin öz son tarixçəsinə əsaslanır) və trend_percent/trend_direction (up/up-slight/down/down-slight/stable, son 3 saatı müqayisə edir). Tamamilə additiv.

/api/v1/data/queue-nin data[] sətirlərində əvvəllər əksər mənbələr üçün wait_time: null var idi — yalnız bir neçə yuxarı axın lenti gözləmə vaxtını birbaşa bildirir. Onsuz olan sətirlər indi standart təxminini alır, yeni wait_time_estimated boolean ilə işarələnir ki, real bildirilmiş rəqəmi hesablanmışdan ayıra biləsiniz.

queue-advanced indi hər çağırış üçün 1 əvəzinə 1.5 vahid təşkil edir (etdiyi əlavə trafik/hava/sürücü-hesabatı sorğularını əks etdirir) — yuxarıda usage.used-ə baxın. Cavab həmçinin artıq total_crossing_time daxil etmir və driver_reported indi sadəcə {wait_min, ts, age_min}-dir — əvvəlki proqnoz-reallıq müqayisə sahələri (prognosed_wait_min, diff_min, historical_section_mode, historical_weather və s.) silindi. section_mode, weather, advanced_wait_min və exceeds_crossing_time dəyişməzdir.

/api/v1/data/truck-bans indi bans_by_country-dəki hər ölkə üçün bir status (active/clear) və əlavə olaraq active_window, next_window, local_time və tz qaytarır — o ölkənin öz saat qurşağında hesablanır, beləliklə artıq xam qadağa pəncərələrini özünüz saata görə qiymətləndirməli deyilsiniz. Cavab həmçinin yuxarı səviyyəli covered_countries siyahısı və bir as_of UTC vaxt möhürü əlavə edir.

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

Tamamilə additiv — mövcud current_bans/upcoming_bans/bans_by_country sahələri dəyişməzdir. Naməlum ?country= indi hər ölkənin qadağaları əvəzinə countries_not_covered ilə boş nəticə qaytarır.

Standart gözləmə vaxtını canlı trafik axını və hava üçün tənzimləyən yeni könüllü məhsul. Hər tənzimləmənin tam təfərrüatını qaytarır.

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

Sorğu ilə verilir — onu aktivləşdirmək üçün idarə panelinizdən Data bileti açın.

/api/v1/data/border indi queue və multi məhsullarına uyğun olaraq cavabdakı hər keçid məntəqəsi üçün wait_min-i düzgün hesablayır. Əvvəllər bu sahə həmişə null idi.

/api/v1/data/forecast indi istənilən prediction_steps dəyəri üçün etibarlı şəkildə v4 ansambl modelindən istifadə edir (əvvəllər bəzi qeyri-standart üfüqlər səssizcə köhnə modelə keçə bilərdi). Ansamblı qidalandıran hava amili də düzəldildi və indi həmişə əlçatmaz bildirmək əvəzinə həqiqətən canlı şəraiti (yağış, qar, külək, duman) əks etdirir.

Təsdiqlənmiş developerlər indi yeni Data export tabından 5-ə qədər keçid məntəqəsi üçün saatlıq ortalanmış tarixi sərhəd növbəsi məlumatını (90 günə qədər sürüşən pəncərə) CSV və ya NDJSON kimi yükləyə bilər. Məlumat yalnız dərc olunmuş və keyfiyyət yoxlamasından keçmişdir; vaxt möhürləri UTC-dir. Giriş lazımdır? Data bileti açın.

Hələ veb saytınız yoxdur? İndi canlı səhifə URL-i daxil etməyə məcbur edilmək əvəzinə, məlumatlarımızı harada və necə istifadə etməyi planlaşdırdığınızı təsvir edərək developer hesabı yarada bilərsiniz. Saytınız və ya tətbiqiniz canlı olan kimi real URL-i sonra idarə panelinizdən (Account & data → Your project) əlavə edin — həmin səhifədə nakordoni.eu-ya görünən keçid Şərtlərimizlə tələb olunur.

Developerlər indi Nakordoni xəbər lentinə öz sərhədlə bağlı xəbərlərini təqdim edə bilər. Redaktorlarımız onu dərc edərsə, xidmətinizə indekslənə bilən dofollow backlink (naşir imzası + mənbə sətri) alırsınız və biz məqaləni pulsuz olaraq bütün 24 dilə tərcümə edirik.

Həftədə bir məqalə pulsuzdur; əlavə məqalələr ödənişli əlavədir. 'yüngülcə redaktə edə + daxili keçidlər əlavə edə bilərik' və ya 'olduğu kimi dərc et' seçin. Developers → Submit news altında təqdim edin və baxış statusunu izləyin.

Multi-Checkpoint API (/api/v1/data/multi) indi kvotanı ⌈(N PPID × alt-məhsul) / 2⌉ ilə hesablayır — ekvivalent fərdi çağırışların yarısı qədər. Hər iki alt-məhsulla 10 keçid məntəqəsi üçün sorğu indi 20 əvəzinə 10 vahid təşkil edir. Cavabdakı X-Devapi-Units başlığı və meta.units_consumed endirimli məbləği əks etdirir.

Tək API çağırışında 20-yə qədər keçid məntəqəsi üçün canlı növbə statusunu və məlumat təzəliyini əldə edin — hazırda dövrədə çoxlu PPID sorğulayan idarə paneli qurucuları üçün nəzərdə tutulub.

Kvota ədalətli şəkildə tələb olunan N PPID × alt-məhsul kimi sayılır, beləliklə ümumi istifadə fərdi çağırışlarla eynidir — lakin çox əvəzinə bir gediş-gəliş ilə. GreenTravel tipli nümunələr saatda 24+ çağırışdan 2-yə düşür.

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

• include=queue — cari queue_now, təxmini wait_min, məlumat yaşı və keçid məntəqəsi adı
• include=update-info — məlumat təzəliyi, mənbə təsnifatı, saniyə/dəqiqə ilə yaş
• Hər sorğu üçün maksimum 20 PPID; tam idarə paneli məlumatı üçün hər iki alt-məhsulu tək çağırışda birləşdirin
• Cavab meta.units_consumed daxil edir ki, kvota istifadəsini dəqiq izləyə biləsiniz

queue məhsulunun cavabı indi ən son real vaxt məlumatı və hesablanmış proqnozlaşdırılmış gözləmə vaxtı olan yuxarı səviyyəli snapshot obyektini daxil edir — nakordoni.eu hero bölməsində istifadə olunan eyni formul:

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 massivi (tarixi qeydlər) dəyişməzdir — bu tamamilə additiv əlavədir. snapshot-u oxumayan müştərilər təsirlənmir.

Hər PPID üçün bir sorğu etmək əvəzinə verilmiş sərhəd + nəqliyyat növü üzrə bütün keçid məntəqələrini tək çağırışda sorğulayın.

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

• Tək təyinat ölkəsini, vergüllə ayrılmış siyahını və ya birdən hər izlənən qonşuya genişləndirmək üçün all-u dəstəkləyir.
• Nəticələr queue_now üzrə artan sırada çeşidlənir (əvvəlcə ən qısa növbə).
• Tam lokallaşdırılıb: həmin dildə keçid məntəqəsi adlarını almaq üçün ?lang=uk (və ya dəstəklənən 22 dilimizdən hər hansı birini) əlavə edin.

Tam kataloqu nəzərdən keçirmədən keçid məntəqəsi PPID dəyərlərini ada görə kəşf edin.

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

• Tək ad və ya vergüllə ayrılmış siyahını (20-yə qədər) qəbul edir.
• Bütün 24 tərcümə dili üzrə axtarır — Ukrayna, Polyak, Alman və ya istənilən dəstəklənən dildə ad ötürün və o uyğunlaşacaq.
• Həmin məkandakı bütün PPID-ləri nəqliyyat növünə görə qruplaşdırılmış qaytarır (avtomobil / avtobus / piyada / yük maşını).

alternatives məhsulu indi dəstəklənən bütün 22 dildə ?lang= qəbul edir (əvvəllər yalnız 12 idi).

Yeni crossing_type parametri nəqliyyat növü filtrini əvəz etməyə imkan verir — məs. avtobus PPID-dən sorğulasanız belə avtomobil alternativlərini almaq üçün crossing_type=4 ötürün.

checkpoints, border və search cavablarındakı crossing_type_label sahəsi indi dəstəklənən bütün 22 dildə tələb olunan dilə tərcümə olunur. Ölkə adı sahələri (origin_name, destination_name) eyni lokala uyğun gəlir.

Nakordoni Developer API portalı /en/developers ünvanında canlıdır. Sərhəd növbəsi məlumatına, proqnozlara, yanacaq qiymətlərinə, sürücü POI-lərinə və daha çoxuna daxil olmaq üçün pulsuz Explorer açarına (gündə 200 sorğu) qeydiyyatdan keçin.

Başlanğıcda mövcud məhsullar: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.