API dəyişiklik jurnalı

toll-cost məhsulu indi minik avtomobillərinin qiymətini də hesablayır. "vehicle": {"class": "car"} göndərin.

• Minik avtomobili sinfi: marşrutdakı ödənişli məntəqələri və vinyet tətbiq edən hər ölkənin ən ucuz vinyetini hesablayırıq (məsələn, AT və HU 1 günlük vinyetləri). Aralıq nöqtələr olarsa, minik avtomobili marşrutu hesablayırıq.
• Cavab: by_country[] içində cost_eur, gates_eur, vignette_eur və vignette_name qaytarılır. Ödəniş alınan hər məntəqə gate tipli elementdir. Minik avtomobilləri üçün toll_km dəyəri null olur.
• Susmaya görə: class olmasa və ya "class": "hgv" olarsa, məhsul yük maşınlarını əvvəlki kimi hesablayır. Minik avtomobilləri üçün axles, gross_weight_t, euro və co2_class istifadə olunmur.

Sənədlər: Truck Toll Cost.

v3 versiyası truck-route üçün artıq sənədləşdirilib. O, GET https://api.nakordoni.dev/v3/truck-route və GET /api/v3/data/truck-route ünvanlarında mövcuddur. Sorğu parametrləri v2 ilə eynidir. Həmçinin 2026-10-22 tarixindən v3 cavab sahələri əlavə olunub: istirahət dayanacağı qaydaları və eCherha sərhəd gözləmə müddəti.

• Marşrut əvvəlcə xüsusi marşrutlaşdırma serverimizdə hesablanır. Həmin server vaxtında cavab verməzsə, marşrutu əsas serverimiz hesablayır. Cavab formatı eynidir.
• Cavab başlığı X-Route-Source hansı serverin cavab verdiyini göstərir: primary və ya fallback.
• v2 ilə eyni API açarı və eyni kvota sinfi: route, hər çağırış üçün 1 vahid.

v2 dəstəklənməyə davam edir və dəyişmir. v3 versiyasına keçmək üçün sorğu URL-indəki versiyanı dəyişin.

Sənədlər: Truck Route API v3.

v4: plate-recognition (POST /api/v4/data/plate-recognition) üçün versiyası yeni ixtiyari sorğu seçimlərini qəbul edir. Onlar olmadan v4 nəticəsi dəyişmir.

• regions: gözlədiyiniz ölkələr, ISO kodları ilə (məsələn ["PL","DE"]). Ölkə təxmini və oxunuşların sırası bu ölkələrə meyl edir.
• camera_id və timestamp: dəyişdirilmədən qaytarılır: data.camera_id və data.timestamp. Onlar adi sorğu jurnalından başqa saxlanmır.
• config.threshold: balı bu dəyərdən aşağı olan nəticələr kənarda qalır.
• config.mode: fast nəqliyyat vasitəsinin aşkarlanmasını atlayır, v2-yə yaxın sürət üçün. region yenə doldurulur, vehicle isə null olur.

Seçimləri JSON gövdəsində, multipart sahələri kimi və ya sorğu parametrləri kimi göndərin. Yeni 400 xəta kodları: bad_regions, bad_camera_id, bad_timestamp, bad_config, bad_threshold, bad_mode. v2 dəyişmir və seçimləri nəzərə almır.

Sənədlər: Plate Image Recognition v4.

Yeni v4 versiyası: plate-recognition (POST /api/v4/data/plate-recognition). v2-nin həmişə null qaytardığı iki sahəni doldurur:

• results[].region: nömrə nişanının ISO ölkə kodu olan {code, score} (məsələn, UA), nişanın formatından oxunur. Bir neçə ölkə eyni formatdan istifadə edəndə skor aşağı olur.
• results[].vehicle: nömrə nişanını daşıyan nəqliyyat vasitəsinin {type, score, box} məlumatı. type dəyəri car, bus, truck və ya motorcycle olur.

Sorğu, digər sahələr və xəta kodları dəyişmir. v4 nəqliyyat vasitəsinin aşkarlanmasına görə v2-dən uzun çəkir (adətən hər şəkil üçün 0.5-1.5 s). v2 dəyişmir və hər iki sahə üçün null qaytarmağa davam edir.

Sənədlər: Plate Image Recognition v4.

Yeni məhsul plate-recognition (POST /api/v2/data/plate-recognition). O, nəqliyyat vasitəsinin fotosundakı nömrə nişanlarını oxuyur. Mühərrik Avropa yük maşınları və avtobusları üzərində tənzimlənmiş öz nömrə detektorumuz və oxuyucumuzdur.

• Giriş: bir şəkil (JPEG, PNG, WebP, BMP və ya TIFF, maks. 8 MB) JSON kimi image_url və ya image_base64, sahədə multipart yükləmə kimi image, və ya xam baytlar kimi image/* Content-Type ilə.
• Çıxış: results[] bunlarla: plate, score, candidates[], region, box, dscore və vehicle, həmçinin processing_time ms ilə.
• Xətalar: 400 şəkil yoxdur və ya yanlışdır, 404 no_plate_detected, 413 şəkil 8 MB-dan böyükdür, 500 engine_error.
• Məxfilik: şəkillər yaddaşda emal olunur və heç vaxt saxlanılmır. image_url ictimai ünvan olmalıdır; özəl və daxili ünvanlar, həmçinin onlara yönləndirmələr rədd edilir.

Açarla standart autentifikasiya, kvota sinfi heavy. Əlçatandır: /api/v2/; mövcud heç bir endpoint dəyişməyib.

Yeni məhsul lane-cost-index (GET /api/v2/data/lane-cost-index). Avropada A-dan B-yə bir yüklü yük maşını reysinin xərc indeksini qaytarır: yanacaq, yol haqları, sürücü vaxtı və gündəlik xərclər.

• Giriş: from və to "lat,lng" kimi və ya şəhər id-si, vehicle (məsələn artic_40t), istəyə görə euro, co2_class və empty_return.
• Ölkələr üzrə: km, yol haqqı, dizel litrləri və yanacaq xərci (ƏDV-siz), həmçinin yol haqqı üçün istifadə olunan nəqliyyat vasitəsi sinfi.
• Sürücü vaxtı: sürmə, fasilələr və istirahət AB 561/2006 qaydalarına uyğundur. Sürücü xərci və gündəlik xərclər çıxış ölkəsinin dərəcəsi ilə hesablanır. İspaniya və İtaliyada indi kollektiv müqavilələrdən sürücü dərəcəsi və gündəlik xərc var.
• Trend: trend cari və əvvəlki iki ayın xərc indeksini verir.
• Natamam məlumat: marşrutdakı ölkə üçün yol haqqı və ya yanacaq məlumatı olmadıqda, yaxud çıxış ölkəsinin sürücü dərəcəsi olmadıqda incomplete true olur və cəm aşağı həddir. missing_countries və missing_components nəyin çatışmadığını göstərir.

Bu xərc indeksidir, daşıma qiyməti deyil: nəqliyyat vasitəsinin kapitalı, sığorta, ümumi xərclər və marja daxil deyil.

Kvota: bir sorğu truck-route kimi route sinfinin 1 vahidi sayılır.

Sənədlər: Lane Cost Index.

toll-cost məhsulu indi Fransa, İspaniya və İtaliyanı daha dəqiq hesablayır.

• Fransa və İspaniya: marşrutda iki ödəniş məntəqəsi arasındakı avtomagistral hissəsi avtomagistral operatorunun giriş/çıxış tarifi ilə hesablanır. O, yeni element növü kimi göstərilir: motorway_section; operator və ya yol, iki məntəqə, toll_km və cost_eur ilə. Ölkənin digər ödənişli km-ləri yenə də km üzrə orta dərəcəni istifadə edir.
• Nəqliyyat vasitəsinin sinfi: Fransa: 2 ox üçün sinif 3, 3 və daha çox ox üçün sinif 4. İspaniya: 2 və ya 3 ox üçün Pesados 1, 4 və daha çox ox üçün Pesados 2.
• İtaliya: 2 və 3 oxlu yük maşınlarının indi km üzrə öz dərəcələri var.
• Euro və CO2 sinfi: Fransa, İtaliya və İspaniya tarifləri bu siniflərdən asılı deyil. euro və ya co2_class göndərdikdə bu ölkələr üçün class_fallback dəyəri false olur, class_note isə səbəbini göstərir.
• Ödənişli yol yoxdur: ödənişli yolu olmayan İspaniya marşrutu (məsələn, Saraqosa – Barselona) İspaniyanı cost_eur 0 və scheme not_tolled ilə qaytarır.

Digər ölkələr dəyişmir. Sənədlər: Truck Toll Cost.

Yeni məhsul toll-cost (POST /api/v2/data/toll-cost, JSON gövdəsi). Avropa üzrə marşrutda yük maşını üçün ödənişli yol haqqının məbləğini qaytarır.

• Giriş: marşrut xətti coordinates kimi (məsələn, truck-route həndəsəsi) və ya yük maşını marşrutlaşdırmamızla marşrut qurduğumuz waypoints.
• Nəqliyyat vasitəsi: axles, gross_weight_t, euro və co2_class. İstəyə görə: tariflər üçün date və cəmi üçün currency.
• Ölkələr üzrə: ödənişli km, km üçün EUR ilə faktiki dərəcə, xərc, tarifləndirilmiş nəqliyyat sinfi və tarifin tarixi. Konkret Euro və CO2 sinfi dərəcələri həmin sinif üçün rəsmi tarif olan yerdə istifadə olunur. Əks halda defolt sinfin dərəcəsi istifadə olunur və class_fallback true olur.
• Ayrıca maddələr: avtomagistralların konsessiya hissələri, həmçinin yük maşınları üçün ayrıca haqqı olan tunellər və körpülər (məsələn, Calafat-Vidin).

Kvota: bir sorğu truck-route kimi route sinfinin 1 vahidi sayılır.

Sənədlər: Truck Toll Cost.

İki yeni məhsul: /api/v2. Avtobus səfəri üçün hansı tərəfin günəşdə, hansının kölgədə olacağını və kölgə və ya mənzərə üçün hansı oturacaqların ən yaxşı olduğunu göstərirlər.

• bus-sun-side (/api/v2/data/bus-sun-side), GET: avtobus marşrutları reyestrimizdən marşrut (route_id, dir, date) və ya sərbəst səfər (from, to, depart).
• bus-sun-side, POST: öz marşrutunuzu dayanacaqlar siyahısı, GeoJSON xətti və ya kodlaşdırılmış polyline kimi göndərin. Avtobus parametrlərini əlavə edin (sıralar, oturacaq düzülüşü, qapı tərəfi, pəncərələr, mərtəbə) və ya kataloqdan modeli bununla seçin: bus_model.
• Hava: növbəti 3 gündəki səfərlər üçün marşrut boyunca saatlıq proqnoz istifadə olunur. Sonrakı səfərlər açıq səma üçün hesablanır. Həmişə açıq səma nəticəsini almaq üçün weather=0 göndərin.
• Şəkillər (POST): oturacaq sxemi, marşrut xəritəsi və zaman xətti PNG, WebP və ya JPG formatında URL kimi. Şəkillər 12 saat saxlanılır. Nəticəni öz səhifənizdə göstərmək üçün embed_html də alırsınız. Şəkil URL-ləri bununla başlayır: https://api.nakordoni.dev/images/.
• Animasiya: animation bloku hər 5 dəqiqədən bir kadr ehtiva edir: avtobusun mövqeyi, istiqaməti, günəşin azimutu və hündürlüyü və günəşli tərəf; sizin dilinizdə etiketlər, tərəflər üzrə cəmlər və legenda ilə. Onu çıxarmaq üçün animation=0 göndərin.
• Vidcet: nəticəni WordPress daxil istənilən saytda script teqi və ya iframe ilə göstərin. Vidcet yalnız icazə verdiyiniz domenlərdə (origins) işləyən açıq açardan və öz xəritə plitələrimizdən istifadə edir. WordPress plagini (zip) mövcuddur.
• bus-sun-catalog (/api/v2/data/bus-sun-catalog): bus-sun-side tərəfindən qəbul edilən avtobus modelləri, oturacaq düzülüşü və pəncərələri ilə.

Kvota: şəkilli POST sorğusu 2 vahid sayılır. Bütün digər sorğular 1 vahid sayılır.

Sənədlər: Bus Sun Side.

fleet-compliance-validate artıq (EU) 2020/1054 Qaydasına əsasən dəyişdirilmiş EU 561/2006 tələblərinin daha çoxunu əhatə edir. Mövcud cavab sahələri dəyişmir; yeni sahələr əlavə olunur.

• Mad. 12 istisnası: sürücülük fəaliyyətlərini art12_exceed: true ilə qeyd edin. İstisna hallarda sürücü həftəlik istirahət üçün əməliyyat mərkəzinə və ya evə çatmaq məqsədilə gündəlik və həftəlik sürücülük limitlərini 1 saata qədər, adi həftəlik istirahət ardınca gəldikdə isə 30 dəq fasilədən sonra 2 saata qədər aşa bilər. Validator bunu qəbul edir və borclu olunan kompensasiyanı və onun son tarixini (sonrakı üçüncü həftənin sonu) remaining.driving.art12_compensation və exceptions.art12 sahələrində qaytarır.
• Mad. 8(8a) bazaya qayıdış: həftəlik istirahətlərdə location göndərin (residence, operational_centre və ya elsewhere). Ardıcıl 4 həftə evdə və ya əməliyyat mərkəzində adi həftəlik istirahət olmadıqda xəbərdarlıq alırsınız.
• Mad. 8(6a) 12 günlük istisna: birdəfəlik beynəlxalq sərnişin avtobus xidməti üçün passenger_12day: true. Bu halda həftəlik istirahət adi həftəlik istirahətdən sonra on iki 24 saatlıq dövrə qədər gecikə bilər. Ondan sonrakı istirahətlər və gecə sürücülüyü (22:00-06:00) yoxlanılır. AETR Mad. 8(6)(b) eyni qaydada tətbiq olunur.
• Milli gecə pəncərələri (Direktiv 2002/15/EC Mad. 3(h)): milli gecə dövrünü tətbiq etmək üçün country və ya wtd.country istifadə edin. Yoxlanılıb: AT, IE (sərnişinlər ayrıca) və SE. Digər aİ/İƏZ ölkələri 00:00-04:00 istifadə edir və night_window_verified: false qaytarır.
• fleet-compliance-limits: AETR indi 2010-dan sonra yoxlanılmış düzəlişləri göstərir. Onlar yalnız 14-cü maddəni dəyişir, sürücülük və ya istirahət qaydalarını dəyişmir.

Sənədlər: Fleet Compliance.

/api/v2 vasitəsilə təqdim olunan və 51 ölkə (Avropa və Körfəz: SA, AE, QA, KW, BH, OM) üçün 2020-2035 illəri üzrə öz bayram qaydaları mühərrikimizlə hesablanan dörd yeni məhsul:

• holiday-calendar-holidays (/api/v2/data/holiday-calendar/holidays) — il və ya tarix aralığı üzrə 10-a qədər ölkə üçün dövlət, bank, regional, dini və anım bayramları. Hər bayram bildirir: istirahət günüdür, bank bayramıdır, yoxsa məktəb tətilinə düşür; həftə sonu bayramı başqa günə keçirilibmi; İslam təqvimi tarixi hələ təxminidirmi; həmin gün yük maşınlarının hərəkətinə qadağa tətbiq olunurmu (truck_ban). Region (region=DE-BY), növ, dil və ad üzrə filtrləyin; school=1 məktəb tətillərini əlavə edir.
• holiday-calendar-business-days (/api/v2/data/holiday-calendar/business-days) — iki tarix arasında iş günlərini sayın, iş günləri əlavə edin və ya çıxın, tarixi yoxlayın, növbəti və ya əvvəlki iş gününü tapın. Ölkənin həftə sonu (şənbə-bazar, yaxud Körfəzdə cümə-şənbə və digər həftə sonları), milli və regional istirahət günləri və fərmanla gün köçürmələri nəzərə alınır.
• holiday-calendar-countries (/api/v2/data/holiday-calendar/countries) — əhatə olunan ölkələr: həftə sonu günləri, saat qurşağı, regionlar və bayram növləri ilə; country= ilə həmçinin ildə iş günləri və növbəti beş bayram.
• holiday-calendar-impact (/api/v2/data/holiday-calendar/impact, Pro plan və yuxarı) — model əsasında qiymətləndirilən biznes təsiri: hər bayram üçün 0-100 təsir balı, mağazaların bağlanma ehtimalı, tələb kateqoriyaları, uzun həftə sonu və körpü günü mövqeyi və tələb artımı pəncirələri. holiday-calendar-holidays məhsulunda Pro və yuxarı planlar bu bloku include=impact ilə də alır və min_impact ilə filtrləyə bilir.

Mövcud holiday-calendar məhsulu dəyişmir. Sənədlər: Holiday Calendar.

Sürücülük vaxtına uyğunluq üçün /api/v2 vasitəsilə təqdim olunan üç yeni məhsul:

• fleet-compliance-validate (POST /api/v2/data/fleet/compliance/validate, JSON gövdəsi) — qeydə alınmış sürücü fəaliyyətini EU 561/2006 və ya AETR və Directive 2002/15/EC iş vaxtı üzrə yoxlayır. Hər pozuntunu qaydanın maddəsi və ciddilik zolağı ilə, həmçinin sürücüdə hazırda qalanları qaytarır: gündəlik sürücülük, sürüşən 56 saatlıq həftəlik və 90 saatlıq iki həftəlik limitlər, növbəti fasilə, gündəlik və həftəlik istirahət. Bölünmüş fasilələri, qısaldılmış və uzadılmış günləri, qısaldılmış həftəlik istirahətin kompensasiyasını, gecə işini, ikili ekipajı və bərə ya qatarla kəsilmiş istirahəti əhatə edir.
• fleet-compliance-limits (/api/v2/data/fleet/compliance/limits) — EU 561, AETR (561-dən fərqləri ilə) və 2002/15 üçün qayda parametrləri, həmçinin Regulation (EU) 2016/403 ciddilik zolaqları.
• fleet-compliance-plan-check (POST /api/v2/data/fleet/compliance/plan-check, JSON gövdəsi) — planlaşdırılmış növbələri göndərişdən əvvəl səfər ölkələrindəki yük maşınlarının hərəkətinə qadağalara, dövlət bayramlarına və həftə sonu günlərinə, eləcə də EU 561, AETR və 2002/15 qaydalarına görə yoxlayır. Hər növbə üçün ən erkən qanuni başlama vaxtı verilir.

Sənədlər: Fleet Compliance.

v3-dən gündəlik və həftəlik istirahət dayanacaqlarında in_vehicle_allowed, accommodation_required və rule sahələri var (rest_rules=eu561 ilə route-plan və truck-route). (Aİ) 2020/1054 reqlamenti EU 561/2006 maddə 8(8)-i dəyişdi: müntəzəm həftəlik istirahət və 45 saatdan uzun hər hansı həftəlik istirahət nəqliyyat vasitəsində keçirilə bilməz. Bu dayanacaqlar üçün in_vehicle_allowed = false. Azaldılmış həftəlik istirahət (24 saatdan 45 saatdan azadək) və gündəlik istirahət yataq yeri olan dayanmış nəqliyyat vasitəsində keçirilə bilər.

Həftəlik istirahət dayanacaqlarında həmçinin accommodation[] var — dayanacağın yaxınlığında yerində otaqları olan parkinqlər, dayanacağın parkinqində isə has_accommodation var. Bu yalnız məlumatdır: dayanacaq, onun vaxtı və yük maşınları parkinqi dəyişmir. Otaqlı yer məlum deyilsə, dayanacaqda warning = no_accommodation_found olur. v1 və v2 cavabları dəyişmir.

/api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest, /api/v2/data/fuel-local və mode=nearest ilə /api/v2/data/fuel daxilindəki məntəqə qiymətlərinin indi maksimum yaşı 90 gündür. Sonuncu dəfə 90 gündən əvvəl təsdiqlədiyimiz qiymət artıq qaytarılmır. Əvvəllər belə qiymət stale = true ilə qaytarılırdı.

Cavablarda nə dəyişir: yalnız daha köhnə qiyməti olan yanacaq növü prices daxilində yoxdur; heç bir qiyməti qalmayan məntəqə siyahıya düşmür və ya qiymətsiz məntəqələrin göstərildiyi yerdə boş prices obyektinə malik olur; əvvəllər köhnə qiymətlər olan yerdə isə cavab boş ola bilər. Boş cavab həmişəki kimi empty_reason ehtiva edir. Bu halda fuel-local region və ya ölkə səviyyəsindən cavab verə bilər. stale bayrağı dəyişmir: qiymət sonuncu dəfə 7 gündən əvvəl təsdiqlənibsə, o true olur. Qiymət tarixçəsi saxlanılır. fuel-cities, fuel-cost, milli orta qiymətlər və fuel-grades üçün praktiki dəyişiklik yoxdur. Ətraflı: Qiymətin yaşı.

GET /api/v2/data/route-plan v2-də genişləndirilmiş dayanacaq modeli (yalnız əlavələr: heç nə silinməyib və ya adı dəyişməyib) və v3-də yeni standart dəyərlər (/api/v3/data/route-plan) alır.

v2, əlavə. stop_places=1 ilə hər dayanacaq (fasilə, yemək, gecələmə, həftəlik istirahət) places[] daşıyır: dayanacaq ətrafında sürüş vaxtı pəncərəsində namizəd parklar, hər biri name, type, country, lat, lon, at_km, at_drive_s, offset_min, off_route_km, detour_km, exceeds_4h30 və type_rank sahələri ilə. Axtarışı places_before_min, places_after_min, places_radius_km və rest_radius_km ilə tənzimləyin; 25 km-dən böyük radius məhdudlaşdırılır və radius_clamped xəbərdarlığı ilə bildirilir. rest_rules=legacy|eu561 istirahət modelini seçir, eu561 ilə isə sürücü vəziyyətini göndərə bilərsiniz: driven_since_break_min, driven_today_min, duty_started_min_ago, driven_week_min, driven_fortnight_min, extended_days_used, reduced_rests_used və allow_reduced. Yeni dayanacaq növləri: ban_wait (ban ilə: name, country, from, until) və weekly_rest; fasilə və ya istirahəti əvəz edən gözləmə counts_as ilə işarələnir. Ukraynadan çıxışda elektron növbəsi olan yük maşını keçidləri registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note və registration_url sahələrini və echerha_registration və echerha_wait_unverified xəbərdarlıqlarını əlavə edir.

v3, yeni standart dəyərlər. rest_rules standart olaraq eu561-dir; yer adları sərtdir (yalnız real parklar və istirahət yerləri); eCherha-nın dərc etdiyi gözləmə vaxtı (təzə məlumat, məhdudiyyətsiz) sərhəd gözləməsi kimi istifadə olunur, sərhəd gözləməsi isə vaxtı çatmış fasilə və ya istirahət sayılır. v2 köhnə istirahət modelini və yerlərin ilkin filtrini saxlayır, ona görə mövcud inteqrasiyalar dəyişmir. Ətraflı: Route Planner API.

GET /api/v3/data/truck-route artıq sərhəddə eCherha gözləməsindən istifadə edir. v3-də Ukraynadan çıxışda elektron növbəsi olan yük zolaqları üçün border_crossings[] wait_min dəyərini eCherha-nın dərc etdiyi gözləmə vaxtından götürür (yalnız təzə məlumat, məhdudiyyətsiz; köhnəlibsə, wait_min null olur və echerha_wait_unverified xəbərdarlığı əlavə edilir) və registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note və registration_url sahələrini daşıyır, echerha_registration xəbərdarlığı ilə.

İstirahət planı sərhəd gözləməsini sərhəddə keçirilən vaxt kimi qəbul edir: uzun növbə vaxtı çatmış fasilə, gündəlik və ya həftəlik istirahət sayılır (waits[] sətirində counts_as), üstünə əlavə edilmir. v2 dəyişməyib. Ətraflı: Truck Route API.

/api/v2/data/fuel-stations və ya /api/v2/data/fuel-cheapest heç bir stansiya tapmadıqda cavab yenə boş siyahı ilə HTTP 200 olur və artıq səbəbi də bildirir. Yalnız boş cavabda data-da empty_reason (no_station_in_radius, no_price_for_fuel_type, fuel_type_not_priced_in_country, unknown_fuel_type və ya no_fresh_price_in_radius), nearest_station_km (yanacaq növünüzü təklif edən ən yaxın stansiya, axtarış nearest_search_km = 50 km-dək; yoxdursa null), country və suggestion — lang dilinizdə bir qısa cümlə olur, məsələn: 5 km daxilində stansiya yoxdur — ən yaxını 6,4 km aralıdadır; radius_km=10 yoxlayın.

Kodunuzu empty_reason və nearest_station_km üzrə budaqlandırın. suggestion insanlar üçün tövsiyədir və formulası dəyişə bilər. Radiusu sizin əvəzinizə heç vaxt genişləndirmirik. Ərazini və ya marşrutu şəbəkə üzrə nümunə götürürsünüzsə, radius_km 10–15 istifadə edin. Stansiyaları olan cavablar dəyişməyib. Ətraflı: Boş cavablar.

Axtarış radiusu. /api/v2/data/fuel-stations-də radius_km artıq bir onluq rəqəmi saxlayır. 4.8 kimi radius əvvəllər xəbərdarlıq olmadan 4-ə qədər kəsilirdi, buna görə hər axtarış tələb olunandan üçdə birinədək az sahəni əhatə edir və daha az stansiya qaytara və ya heç nə qaytarmaya bilərdi. anchor.radius_km həqiqətən tətbiq olunan radiusu göstərir; tam ədədlər əvvəlki kimi qaytarılır.

Brend adları. Eyni brend artıq brand-də həmişə eyni cür yazılır — məsələn, ORLEN və orlen Orlen kimi, CircleK isə Circle K kimi qaytarılır. Stansiyalar, qiymətlər, identifikatorlar və sahələr dəyişməyib. Brendləri dəqiq yazılışa görə uyğunlaşdırırsınızsa (loqolar və ya filtrlər üçün), siyahınızı yeni adlarla yoxlayın.

GET /api/v2/data/truck-route yeni könüllü traffic parametrini qəbul edir. O, ETA, istirahət planı, sərhədə çatma vaxtları və yük maşınlarına qadağa vaxtları üçün tıxacın necə nəzərə alınacağını müəyyən edir:

• forecast (susmaya görə): yük maşınının hər hissədən keçdiyi saatda təkrarlanan tıxaclar, çatma vaxtına yaxınlaşdıqca azalan cari tıxaclar, marşrutdakı yol işləri və bağlanmalar, və məlumatımız olan yerdə hava. Cavabda gecikmənin səbəblər üzrə bölündüyü traffic_forecast bloku olur.
• live: yalnız cari tıxac, təkrarlanan tıxaclar olmadan.
• off: tıxac düzəlişi yoxdur; vaxtlar sərbəst hərəkətdə yük maşını mühərrikinin hesabladığı vaxtlardır. Bu halda traffic_forecast yalnız model və mode ehtiva edir.

Hər hansı digər dəyər 400 bad_request qaytarır, mesaj: Invalid traffic: forecast, live or off. Parametrsiz sorğular susmaya görə dəyəri, yəni forecast alır.

Proqnozlaşdırılan çatma vaxtında yük maşını qadağaları: forecast və ya live ilə truck_bans[].active artıq yük maşınının hər qadağaya çatacağı proqnozlaşdırılan vaxta görə (depart_at-dən, göndərilməyibsə indidən), həmin qadağa üçün hər hansı gözləmədən əvvəl qiymətləndirilir. Yeni truck_bans[].active_at sahəsi qiymətləndirilən vaxtı qadağa ölkəsinin yerli vaxtı ilə verir. bans_summary, restriction_hits və legal eyni nəticələrə əsaslanır, proqnozlaşdırılan gecikmənin yeni rast gəldiyi qadağa (məsələn, sonrakı gündə və ya başqa ölkədə) də truck_bans-da göstərilir. traffic=off ilə active sərbəst hərəkət zaman xəttində qiymətləndirilir və active_at eta_at_ban-a bərabərdir.

Yeni məhsul: Truck Route API (GET /api/v2/data/truck-route, yalnız v2). Bir sorğu yük maşını üçün qanuni marşrutu və dispetçerin yol boyu ehtiyac duyduğu hər şeyi qaytarır. Marşrut öz xəritə məlumatlarımız əsasında TruckTurn yük maşını naviqasiya tətbiqimizlə eyni marşrutlaşdırma nüvəsi tərəfindən hesablanır.

• Nəqliyyat vasitəsi: height, width, length, weight, axle_load, axles, trailers, emission_class, hazmat (ADR sinifləri) və adr_tunnel (B–E). Yük maşınlarının hərəkət qadağaları və məhdudiyyət zonaları qaytarılan xətt üzərində yoxlanılır.
• Marşrut boyu: cari qiymətlərlə yanacaq doldurma məntəqələri, yük maşını parklanma yerləri və çəki məntəqələri; hər biri km_from_start və yoldan kənara çıxma məsafəsi ilə.
• AB 561/2006 Reqlamentinə əsasən sürücünün istirahət planı: fasilələr (bölünmüş 15+30 daxil olmaqla), gündəlik və həftəlik istirahət (qısaldılmış daxil olmaqla), tək sürücü və ya iki sürücülü heyət (crew=2); sürücünün cari vəziyyətini ötürsəniz, plan həmin vəziyyətdən başlayır. Hər dayanacaq marşrut üzərindəki real parklanma yerinə yerləşdirilir. Bu planlaşdırma vasitəsidir, taxoqraf qeydi deyil.
• ETA istirahətləri, yük maşını hərəkət qadağalarını və sərhəd gözləmələrini nəzərə alır. Planlaşdırma depart_at və ya arrive_at ilə aparılır.
• Ölkələr üzrə yol haqqı təxminləri (EUR, oxların sayına və emissiya sinfinə görə); qiymətləndirilməyən ölkələr tolls.coverage_note sahəsində göstərilir. Həmçinin avoid (ödənişli yollar, bərələr, avtomagistrallar, sərhədlər, tunellər, asfaltsız yollar, aşağı emissiyalı zonalar), 2-yə qədər alternativ, ölkələr üzrə bölgü və geometry üçün polyline5, polyline6 və ya GeoJSON.

Kvota: ayrıca truck-route limiti: hər hesabda gündə 10 sorğu, ödənişli planlarda daha çox və Əlavə truck-route sorğuları əlavəsi. Sandbox mühitində gündə 10 yük maşını marşrutu işlədə, nəticəni tam marşrut planı ilə xəritədə görə və GPX, KML, GeoJSON, CSV, təqvim (.ics) və ya ITN formatında ixrac edə bilərsiniz. Məhsul səhifəsinə və sorğu sənədinə baxın.

API Şərtlərinə görə, Market — istifadə etdiyiniz məlumatların aid olduğu ölkədir, açarınız isə hesabınız üçün təsdiqlənmiş ölkələri əhatə edir. İndiyə qədər koordinat əsaslı məhsullar (lat/lon — məs. Nearby Shops, Truck Parkings, Fuel Stations) Avropanın istənilən nöqtəsi üçün cavab verirdi. 13 oktyabr 2026-dan etibarən, bu, sorğunuz emal edilərkən yoxlanılır:

• lat/lon dəyəri hesabınız üçün təsdiqlənməmiş ölkədə yerləşən sorğu 403 qaytarır, error.code kimi market_not_allowed olur. Mesajda ölkə və təsdiqlənmiş siyahınız göstərilir.
• Radius sərhədi keçdikdə, country_code-u təsdiqlənmiş ölkələrinizdən kənarda olan nəticələr silinir. Bu zaman cavabda markets_filtered (neçəsinin silindiyi) və markets_notice olur, total_found isə yalnız aldığınız nəticələri sayır.

Bu, ölkələri yoxlanılmış hesablara aiddir (approved və ya partial statusu). Sorğuda heç nə dəyişmir — yeni parametr yoxdur, yeni versiya yoxdur. Tətbiqinizə başqa bir ölkə lazımdırsa, onu 13 oktyabra qədər developer portalında əlavə edin. market_not_allowed istinad sənədində digər xəta kodları ilə birlikdə sadalanıb.

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.

Fuel Prices xidmətində updated_at və cavabın öz age_hours/stale bayrağı fərqli saatlarla işləyirdi: updated_at yalnız qiymət həqiqətən dəyişəndə irəliləyir, lakin köhnəlmə hər təsdiqdə irəliləyirmiş kimi hesablanırdı. Qiymətli indeksin 46.7%-i age_hours ≤48 və stale:false göstərirdi, halbuki updated_at əslində 48 saatdan köhnə idi, 12,620 məntəqə isə bir həftədən köhnə idi. İndi hər qiymət həm də confirmed_at daşıyır — qiyməti sonuncu dəfə təsdiq etdiyimiz vaxt, saata yuvarlaqlaşdırılmış, heç vaxt updated_at-dan əvvəl olmayan — və age_hours/stale ondan hesablanır. updated_at sahəsinin mənası dəyişməyib: qiymətin sonuncu dəfə nə vaxt dəyişdiyini bilmək üçün onu, hazırda nə qədər aktual olduğunu bilmək üçün isə confirmed_at sahəsini istifadə edin. Dondurulmuş v1 müqaviləsində yoxdur.

Hər ikisi səssiz olan iki dil xətası: kanonik yanacaq növü kodunu lang=pl (və ya digər 24 sayt dilindən hər hansı biri) ilə göndərdikdə fuel_type_local yenə də ingiliscə qayıdırdı — etiket cədvəlində yalnız 10 dil yoxlanılırdı, buna görə həmin siyahıdan kənar hər şey istədiyiniz dil əvəzinə standart interfeys lüğətinə düşürdü. Ayrıca lang=tr (və ya digər bir neçə etibarlı kod) məntəqə siyahılarını ukraynaca qaytarırdı, çünki istənilən dil həmin 10 dilli siyahıda olmadıqda daxili uk defoltu işə düşürdü. Hər ikisi düzəldildi: göndərdiyiniz dil indi bütün 25 dil üzrə aldığınız dildir.

Həmçinin: Nearby Fuel Stations xidmətində brand sahəsi markasını bilmədiyimiz təxminən 330 məntəqə üçün artıq xam yükləmə işarəsi olan OTHER qiymətini qaytarmır — cavabdakı bütün digər naməlum sahələrə uyğun olaraq null qaytarır.

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.