API Değişiklik Günlüğü

If an assistant has a feed enabled but the call does not carry the context that feed needs — queue without a ppid, for example — the feed is now skipped before any request is made and is not charged. Previously it was called anyway, failed, and still cost a unit. The studio shows what each feed needs, recalculates the price as you fill the context in, and marks results ✓ ran / ⊘ skipped, not charged / ✕ failed; the API returns data.feeds_skipped telling you exactly which parameter to pass.

Answers no longer mention feeds, data sources or anything technical: a missing feed is at most one plain sentence to the end user, never an internal name. Feeds with only optional filters (such as fuel narrowed to a country we have no data for) now fall back to the broad dataset instead of returning nothing.

New: /{lang}/developers/studio. Build an AI assistant that answers from your content and our live border data. Give us your markdown, or just name the pages and we fetch and index them — you only ever maintain your own files. Pick which of our feeds it may use (queue, forecast, alternatives, day-stats, fuel, truck bans, trading Sundays, holidays, road conditions, bus carriers, POIs, currency), pick a model tier (fast / balanced / pro — that is what sets the price), write your own instructions with {{feed.slug}} placeholders saying exactly where our data lands in the answer, and add a closing sentence of your own that is appended to every reply. Ready-made blueprints: personal travel assistant, work/freight assistant, insurance & Green Card sales assistant.

Test it in the studio (30 answers/day, separate from your API quota), then call it in production at GET /api/v2/data/assistant-custom?assistant_id=N&q=…. Price per answer = model tier units + 1 unit per enabled feed, returned in X-Devapi-Units. The product is v2-only — a v1 URL returns unsupported_version. The existing assistant product is unchanged.

Every assistant runs under a platform content policy that outranks your instructions: no impersonating officials, no help evading border or customs control, no invented numbers, no profanity. Instructions and answers are both screened; blocked calls are logged.

Yeni: https://nakordoni.eu/mcp adresinde gerçek bir MCP sunucusu, API'nin güvenli, salt okunur bir alt kümesini (status, checkpoints, border queue, live queue, forecast) MCP araçları olarak sunar. REST API ile aynı API anahtarı ve kota. Sunucu kartı /.well-known/mcp/server-card.json adresinde. Belgelerdeki MCP Sunucusu bölümüne bakın.

The retitle to "Live Queue & Freshness API" below did not actually reach the docs page. The page renders each product title through a translation lookup that falls back to the endpoint's title only when no translation exists — and a translation already existed, frozen at the old name, in all 25 UI languages. It now wins over any future update to the underlying title until it is updated too.

Retitled the translation key in all 25 languages so the docs page matches. No endpoint, parameter or response change — title text only.

If you poll live queue data frequently, you may be spending heavy quota you do not need to. /update-info is standard-class and already returns the live figure:

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

It returns queue_now, freshness, age_minutes, is_realtime, status, timestamp and timezone. Use it for the frequent refresh against your standard daily quota, and keep /queue, /multi and /forecast (all heavy-class) for when you need wait_min, the trend fields or history.

Nothing changed in the endpoint itself — only its documentation. It was listed as the "Data Freshness API" and its description mentioned only the freshness rating, never queue_now, so it was easy to miss. It is now titled "Live Queue & Freshness API" with the returned fields spelled out. Thanks to the developer who raised this.

Some failed requests were returning HTTP 200 with ok: true and the error buried inside data — so the documented if (!ok) throw pattern could not detect them, and the call was still billed. Affected calls now return HTTP 400 with ok: false and a proper error.code / error.message, as documented. Seen on fuel-cities with an unsupported country and travel-matrix with malformed coordinates.

Separately, a missing required parameter returned 500 internal_error instead of 400 bad_request (an upstream 4xx body was being discarded before its status was read). It now returns 400 bad_request with the upstream message — e.g. search without ?name=.

Successful responses are byte-for-byte unchanged — same fields, same params, same quota cost. If your client already branches on ok, no change is needed. If it ignored ok and read data directly, it will now see error envelopes on calls that were always failing.

Fixed a bug where /multi could return a wrong queue count for some checkpoints — mainly Balkan and Hungary–Serbia crossings — whenever its cache was cold. The fallback read a table that, for those crossings, holds no queue data, and reported unrelated values as car counts. Measured examples: a checkpoint with 12 cars reported 6, and several with real queues reported 0.

Three changes you may notice:

• found: false now means there is genuinely no recent queue data. Previously you could receive found: true with a fabricated queue_now: 0.
• wait_status, trend_percent and trend_direction are now returned on cold requests — they were null before.
• The endpoint also falls back when its cached snapshot is stale (older than 24h), not only when it is missing.

No changes to request parameters, quota cost or response shape.

Her /multi çağrısının iki kez ücretlendirilmesine neden olan bir hata düzeltildi — önce genel bir 1 birimlik kontrolle, sonra uç noktanın kendi değişken maliyet formülüyle (N PPID × alt ürünler). Bir çağrı artık belgelendiği gibi tam olarak ⌈(N×M)/2⌉ birime mal oluyor, ekstra ücret olmadan.

Ayrıca dokümantasyon sayfasında her ürüne bir Standard/Heavy kota sınıfı rozeti eklendi, böylece bir uç noktanın hangi günlük kotayı kullandığı ilk bakışta netleşir.

country ve countries tek bir parametrede birleştirildi (1-15 virgülle ayrılmış kod). Yeni compare_to parametresi: ülkeler arası aynı/farklı tatil karşılaştırması, upcoming+days ile birlikte çalışır. lang artık birden fazla dili kabul ediyor (bir names nesnesi ekler). days=0 veya belirtilmemesi artık upcoming modunda limit yok anlamına gelir.

Her Avrupa ülkesi için resmi kamu tatilleri — tarihler, yerel adlar ve tür. nakordoni.eu tatil takvimi sayfasını ve tahmin sisteminin takvim faktörlerini besleyen aynı Nager.Date / OpenHolidaysAPI hizmeti (yerel olarak hesaplanan bir Kosova takvimi ile) tarafından desteklenir.

• ?country=PL&year=2026 — bir ülke için tam yıllık tatil listesi
• ?upcoming=1&days=30 — ülkeler genelinde yaklaşan tatillerin düz listesi
• Parametresiz — her bir sonraki tatille birlikte temel ülke kümesinin dizini

currency ürünü eklendi — Frankfurter (ECB) kaynağından alınan ve 6 saat önbelleğe alınan PLN, CZK, HUF, USD, GBP, CHF, NOK ve UAH için EUR tabanlı döviz kurları. Parametre yok, her zaman tam kur tablosunu döndürür. belgelere bakın.

Canlı Avrupa kamyon sürüş yasaklarını kendi web sitenize gömün — 3 tasarım (light, dark, board), 5 dil (en, uk, pl, de, ru), isteğe bağlı ülke bazında filtre ve canlı «şu an aktif» durumu olan ücretsiz bir iframe widget'ı. API anahtarı gerekmez. Kodu nakordoni.eu/en/for_truck_drivers/traffic_bans/widget adresinde yapılandırın ve kopyalayın. Ham veriyi mi tercih edersiniz? truck-bans API ürünü ve genel JSON akışı kullanılabilir durumda kalır.

Üç ekleme, hepsi geriye dönük uyumlu — v1 değişmedi.

Endpoint bazında sürümleme. Artık bir /api/v2/ temel URL'si var. Bu, endpoint bazındadır: yalnızca gerçekten değişen endpointler v2 altında farklı davranır; diğer her endpoint şeffaf biçimde v1 yanıtını sunar (yani /api/v2/data/queue = v1 ile aynı veri, sadece "api_version":"v2" ile). Çalışan endpointleri taşımaya gerek yok.

border v2 yönlüdür. Yol sırası seyahat yönüdür:

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)

Her kontrol noktası ayrıca bir direction {from,to} nesnesi ve bir stale boolean değeri kazanır ve ?max_age_min=N yalnızca son güncellenen geçişleri döndürür. (v1 border sıradan bağımsız olarak hâlâ sınırın her iki tarafını döndürür — değişmedi.)

Etkileşimli Sandbox. Oturum açmış geliştiriciler artık herhangi bir endpointi tarayıcıdan Developers → Sandbox adresinde deneyebilir — bir endpoint, sürüm ve anahtarlarınızdan birini seçin, parametreleri ayarlayın ve canlı yanıtı görün. Sandbox testinin kendi ayrı günlük bütçesi vardır (günde 50 çağrı) ve canlı API kotanıza asla dokunmaz.

Belgeler artık endpoint bazında bölünmüştür (Developers → API Docs) ve birden fazla sürümü olan endpointlerde bir sürüm seçici bulunur.

Mevcut section_mode ve hava durumu ayarlamalarının yanı sıra bekleme süresi formülüne iki yeni faktör eklendi:

• service_rate — şu anda işlenen ölçülen araç/dk değerinin, kontrol noktasının yapılandırılmış temel oranına oranı. Çarpımsal, 0.5x-1.5x ile sınırlı.
• shift_change — kontrol noktasının kendi yerel 08:00/20:00 sınır muhafızı vardiya değişiminin etkisi. Toplamsal (dakika), çarpımsal değil — yalnızca bir vardiyanın +/-60 dakikası içinde uygulanır, asgari bir örnek geçmişi gerektirir, +/-120 dakika ile sınırlandırılır.

advanced_wait_min artık round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min şeklindedir. Her iki faktör de geçmiş karşılaştırmalar için driver_reported.prognosed_advanced_wait_min içinde yansıtılır.

Bir güvenlik/gizlilik incelemesi kapsamında, aşağıdaki alanlar kaldırıldı — bunlar gerçek bir ürün değeri olmadan dahili uygulama ayrıntılarını (üst kaynak veri taksonomimiz, DB satır kimlikleri, dahili pipeline açıklamaları, kullanılmayan/ölü alanlar) açığa çıkarıyordu:

• id ve corrected — queue satır nesnelerinden kaldırıldı
• tmin/tpercar — queue, border ve multi ürünlerinden kaldırıldı (bekleme süresi formülü sabitleri; zaten hesaplanmış wait_min/wait_time etkilenmez)
• source (ham dize, ör. "line") — queue, multi ve update-info ürünlerinden kaldırıldı. update-info ve multi ürününün update_info bloğu hâlâ source_category/source_label_en taşır (küçük bir genel sözcük dağarcığı); queue ve multi ürününün queue bloğu artık hiçbir source alanı taşımaz
• traffic_status — border ürününden kaldırıldı; her zaman null idi ve sistemin hiçbir parçası tarafından doldurulmadı

Entegrasyonunuz bu alanlardan herhangi birini okuyorsa, lütfen güncelleyin — güncel alan listesini ilgili ürünün belge sayfasında görün.

Günlük kota kullanımı (her yanıtta usage.used) artık her zaman tam sayı yerine ondalık bir değer (ör. 67.5) olabilir. Bu, queue-advanced ürününün kesirli bir oranla faturalandırılmasının bir yan etkisidir — aşağıya bakın. usage.limit etkilenmez ve her zaman tam sayıdır. İstemciniz usage.used değerini kesinlikle tam sayı olarak tipliyorsa, lütfen bir ondalık/float kabul edecek şekilde genişletin.

Bu üç ürün artık web sitesinin gösterdiği aynı canlı durum alanlarını döndürüyor: wait_status (green/yellow/red, bu kontrol noktasının kendi son geçmişine dayalı) ve trend_percent/trend_direction (up/up-slight/down/down-slight/stable, son 3 saati karşılaştırarak). Tamamen ekleyici.

/api/v1/data/queue ürününün data[] satırlarında daha önce çoğu kaynak için wait_time: null vardı — yalnızca birkaç üst kaynak akışı bekleme süresini doğrudan bildirir. Bekleme süresi olmayan satırlar artık standart tmin + queue×tpercar tahminini alır ve gerçek bir bildirilen değeri hesaplanmış olandan ayırt edebilmeniz için yeni bir wait_time_estimated boolean ile işaretlenir.

queue-advanced artık çağrı başına 1 yerine 1.5 birim maliyetindedir (yaptığı ekstra trafik/hava/sürücü-raporu aramalarını yansıtarak) — yukarıdaki usage.used bölümüne bakın. Yanıt ayrıca artık tmin, tpercar veya total_crossing_time içermiyor ve driver_reported artık yalnızca {wait_min, ts, age_min} — önceki tahmin-gerçeklik karşılaştırma alanları (prognosed_wait_min, diff_min, historical_section_mode, historical_weather vb.) kaldırıldı. section_mode, weather, advanced_wait_min ve exceeds_crossing_time değişmedi.

/api/v1/data/truck-bans artık bans_by_country içindeki her ülke için bir status (active/clear) artı active_window, next_window, local_time ve tz döndürüyor — bu, o ülkenin kendi saat diliminde hesaplanır, böylece artık ham yasak pencerelerini bir saate göre kendiniz değerlendirmek zorunda kalmazsınız. Yanıt ayrıca üst düzey bir covered_countries listesi ve bir as_of UTC zaman damgası ekler.

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

Tamamen ekleyici — mevcut current_bans/upcoming_bans/bans_by_country alanları değişmedi. Bilinmeyen bir ?country= artık her ülkenin yasakları yerine countries_not_covered ile boş bir sonuç döndürür.

Standart bekleme süresini canlı trafik akışı ve hava durumuna göre ayarlayan yeni, isteğe bağlı bir ürün. Her ayarlamanın tam dökümünü döndürür.

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

Talep üzerine verilir — etkinleştirmek için panonuzdan bir Data talebi açın.

/api/v1/data/border artık queue ve multi ürünleriyle eşleşecek şekilde yanıttaki her kontrol noktası için wait_min değerini doğru şekilde hesaplıyor (ve tmin/tpercar döndürüyor). Daha önce bu alan her zaman null idi.

/api/v1/data/forecast artık herhangi bir prediction_steps değeri için güvenilir biçimde v4 topluluk modelini kullanıyor (daha önce bazı standart dışı ufuklar sessizce daha eski bir modele geri dönebiliyordu). Topluluğu besleyen hava durumu faktörü de düzeltildi ve artık her zaman kullanılamıyor bildirmek yerine canlı koşulları (yağmur, kar, rüzgâr, sis) gerçekten yansıtıyor.

Onaylı geliştiriciler artık yeni Data export sekmesinden en fazla 5 kontrol noktası için saatlik ortalaması alınmış geçmiş sınır kuyruğu verilerini (90 güne kadar kayan pencere) CSV veya NDJSON olarak indirebilir. Veriler yalnızca yayınlanmış ve kalite kontrolünden geçmiştir; zaman damgaları UTC'dir. Erişime mi ihtiyacınız var? Bir Data talebi açın.

Henüz web siteniz yok mu? Artık canlı bir sayfa URL'si girmeye zorlanmak yerine, verilerimizi nerede ve nasıl kullanmayı planladığınızı anlatarak bir geliştirici hesabı oluşturabilirsiniz. Siteniz veya uygulamanız yayına girer girmez gerçek URL'yi daha sonra panonuzdan (Account & data → Your project) ekleyin — o sayfada nakordoni.eu'ya görünür bir bağlantı Şartlarımız gereği zorunludur.

Geliştiriciler artık kendi sınırla ilgili haberlerini Nakordoni haber hattına gönderebilir. Editörlerimiz yayınlarsa, hizmetinize dizine eklenebilir bir dofollow backlink (yayıncı künyesi + kaynak satırı) alırsınız ve makaleyi ücretsiz olarak 24 dilin tümüne çeviririz.

Haftada bir makale ücretsizdir; ek makaleler ücretli bir eklentidir. 'hafifçe düzenleyebilir + dahili bağlantılar ekleyebiliriz' veya 'olduğu gibi yayınla' seçin. Developers → Submit news altında gönderin ve inceleme durumunu takip edin.

Multi-Checkpoint API (/api/v1/data/multi) artık kotayı ⌈(N PPID × alt ürün) / 2⌉ olarak faturalandırıyor — eşdeğer bireysel çağrıların yarısı maliyetinde. Her iki alt ürünle 10 kontrol noktası için bir istek artık 20 yerine 10 birim maliyetindedir. Yanıttaki X-Devapi-Units başlığı ve meta.units_consumed indirimli tutarı yansıtır.

Tek bir API çağrısında en fazla 20 kontrol noktası için canlı kuyruk durumunu ve veri tazeliğini alın — şu anda bir döngüde birçok PPID'yi yoklayan pano geliştiricileri için tasarlandı.

Kota adil biçimde istenen N PPID × alt ürün olarak sayılır, dolayısıyla toplam kullanım bireysel çağrılarla aynıdır — ancak çok yerine tek bir gidiş-dönüş ile. GreenTravel tarzı desenler saatte 24+ çağrıdan 2'ye düşer.

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

• include=queue — güncel queue_now, tahmini wait_min, veri yaşı ve kontrol noktası adı
• include=update-info — veri tazeliği, kaynak sınıflandırması, saniye/dakika cinsinden yaş
• İstek başına en fazla 20 PPID; tam pano verisi için her iki alt ürünü tek bir çağrıda birleştirin
• Yanıt meta.units_consumed içerir, böylece kota kullanımını hassas biçimde takip edebilirsiniz

queue ürününün yanıtı artık en son gerçek zamanlı verileri ve hesaplanmış tahmini bir bekleme süresini içeren üst düzey bir snapshot nesnesi içeriyor — nakordoni.eu hero bölümünde kullanılan aynı formül:

snapshot.queue_now  — current cars in queue
snapshot.wait_min   — tmin + queue_now × tpercar (minutes)
snapshot.tmin       — minimum crossing time (minutes)
snapshot.tpercar    — added time per vehicle (minutes)
snapshot.updated_at — when the queue data was recorded
snapshot.age_min    — minutes since last update
snapshot.source     — data source identifier

data dizisi (geçmiş girişler) değişmedi — bu tamamen ekleyici bir eklemedir. snapshot öğesini okumayan istemciler etkilenmez.

Her PPID için bir istek yapmak yerine, belirli bir sınır + araç türündeki tüm kontrol noktalarını tek bir çağrıda sorgulayın.

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

• Tek bir hedef ülkeyi, virgülle ayrılmış bir listeyi veya bir kerede izlenen her komşuya genişletmek için all değerini destekler.
• Sonuçlar queue_now değerine göre artan sırada sıralanır (önce en kısa kuyruk).
• Tamamen yerelleştirilmiş: o dilde kontrol noktası adlarını almak için ?lang=uk (veya desteklenen 22 dilimizden herhangi birini) ekleyin.

Tam dizini taramadan kontrol noktası PPID değerlerini ada göre keşfedin.

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

• Tek bir adı veya virgülle ayrılmış bir listeyi (en fazla 20) kabul eder.
• Tüm 24 çeviri dilinde arama yapar — Ukraynaca, Lehçe, Almanca veya desteklenen herhangi bir dilde bir ad girin, eşleşecektir.
• O konumdaki tüm PPID'leri araç türüne göre gruplandırılmış olarak döndürür (araba / otobüs / yaya / kamyon).

alternatives ürünü artık desteklenen tüm 22 dilde ?lang= kabul ediyor (önceden yalnızca 12 idi).

Yeni crossing_type parametresi, araç türü filtresini geçersiz kılmanıza olanak tanır — örn. bir otobüs PPID'sinden sorgularken bile araba alternatiflerini almak için crossing_type=4 geçirin.

checkpoints, border ve search yanıtlarındaki crossing_type_label alanı artık desteklenen tüm 22 dilde istenen dile çevriliyor. Ülke adı alanları (origin_name, destination_name) aynı yerel ayarı izler.

Nakordoni Developer API portalı /en/developers adresinde yayında. Sınır kuyruğu verilerine, tahminlere, yakıt fiyatlarına, sürücü POI'lerine ve daha fazlasına erişmek için ücretsiz bir Explorer anahtarına (günde 200 istek) kaydolun.

Lansmanda mevcut ürünler: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.