API Dokümantasyonu

Kimlik doğrulama

Her istek, API anahtarınızı Authorization üst bilgisinde (önerilen) veya ?key= parametresi olarak gerektirir.

curl "https://nakordoni.eu/api/v1/data/queue?ppid=id_13" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Yanıt zarfı

{
  "ok": true,
  "api_version": "v1",
  "product": "queue",
  "attribution": "Data by nakordoni.eu",
  "data": { ... },
  "usage": { "limit": 1000, "used": 42, "reset": "2026-06-06T00:00:00Z" }
}

Hatalar, error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) ve HTTP durumu 401/403/404/429/500 ile ok:false döndürür. X-Devapi-Limit ve X-Devapi-Remaining hız sınırı üst bilgileri, ölçülen her yanıtta gönderilir.

Kotalar

Günlük sayaçlar gece yarısı UTC'de sıfırlanır. Kotanın %80 ve %100'ünde bir e-posta alırsınız.

Ücretli planlar bu limitlerin her birini yükseltir. Güncel planlar ve kotaları: Planlar

Kod örnekleri

curl

curl "https://nakordoni.eu/api/v1/data/queue?ppid=id_13" \
  -H "Authorization: Bearer $NKD_API_KEY"

JavaScript (fetch)

const res = await fetch('https://nakordoni.eu/api/v1/data/forecast?ppid=id_13&prediction_steps=24', {
  headers: { Authorization: `Bearer ${process.env.NKD_API_KEY}` }
});
const { ok, data, error, usage } = await res.json();
if (!ok) throw new Error(error?.code ?? res.status);
console.log(`forecast points: ${data.length}, calls left today: ${usage.limit - usage.used}`);

Python (requests)

import os, requests

r = requests.get(
    "https://nakordoni.eu/api/v1/data/stats",
    params={"ppid": "id_15", "compare": 1},
    headers={"Authorization": f"Bearer {os.environ['NKD_API_KEY']}"},
    timeout=15,
)
payload = r.json()
print(payload["data"]["daily"], payload["usage"])

Excel (Power Query)

Power Query'nin yerleşik JSON bağlayıcısıyla canlı kuyruk, tahmin veya kamyon yasağı verilerini doğrudan bir çalışma kitabına alın — kod yok, zamanlanmış yenileme. Aynı Headers şeması bu API'deki her ürün için çalışır — sadece URL'yi değiştirin.

Data → Get Data → From Other Sources → Blank Query, then Home → Advanced Editor and paste:

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v1/data/queue",
        [Query = [ppid = "id_13"], Headers = [Authorization = "Bearer " & ApiKey]])),
    data = Source[data],
    AsTable = Record.ToTable(data)
in
    AsTable

API anahtarını bir sayfa hücresinde değil, M sorgusunun içinde saklayın (Home → Advanced Editor) — gizlilik düzeyi Organizational olarak ayarlanmadıkça Power Query, başka bir sorgu veya hücreden oluşturulan web isteğini engeller ("Formula.Firewall").

Tek tabloda birden fazla sınır kapısı (filo panoları) — e.g. every truck crossing UA→EU (crossing_type=9):

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v1/data/border/1/all/9",
        [Headers = [Authorization = "Bearer " & ApiKey]])),
    checkpoints = Source[data],
    AsTable = Table.FromRecords(checkpoints)
in
    AsTable

Excel'de Data → Refresh All veya Power BI / Excel Online'da zamanlanmış yenileme, sayıları güncel tutar — polling kodu gerekmez.

ERP entegrasyonu (BAS / BAF ve 1C ailesi platformlar)

BAS / BAF ve diğer 1C ailesi platformlar bu API’yi doğrudan zamanlanmış bir görevden çağırabilir — HTTPConnection ve ReadJSON, ara katman ya da barındırılacak ek servis olmadan. En yaygın kurulum, AB akaryakıt fiyatlarını tutan bir bilgi kaydını güncel tutar.

Bilgi kaydını yenileme (akaryakıt fiyatları, tüm ülkeler tek çağrıda)

// Scheduled job — runs once a day
Connection = New HTTPConnection("nakordoni.eu", 443, , , , 30, New OpenSSLSecureConnection);

Headers = New Map;
Headers.Insert("Authorization", "Bearer NKD-DEV-XXXX-XXXX-XXXX");

Request  = New HTTPRequest("/api/v1/data/fuel", Headers);
Response = Connection.Get(Request);

Reader = New JSONReader;
Reader.SetString(Response.GetBodyAsString("UTF-8"));
Answer = ReadJSON(Reader, True);
Reader.Close();

If Answer["ok"] <> True Then
    // Answer["error"]["code"] says why; Answer["usage"] holds your quota state
    Return;
EndIf;

For Each Row In Answer["data"] Do
    Record = InformationRegisters.FuelPrices.CreateRecordManager();
    Record.Period   = CurrentSessionDate();
    Record.Country  = Row["country"];    // "PL", "DE", "SK", "RO", ...
    Record.Diesel   = Row["diesel"];
    Record.Petrol   = Row["petrol"];
    Record.LPG      = Row["lpg"];
    Record.Currency = Row["currency"];
    Record.Write();
EndDo;

Üç noktayı doğru yapın: 443 numaralı bağlantı noktasında New OpenSSLSecureConnection geçin, yoksa istek TLS’te düşer; /api/v1/data/fuel adresini country parametresi olmadan çağırın ki tek istek her ülke için ayrı çağrı yerine hepsini döndürsün; ve data’ya dokunmadan önce ok değerini kontrol edin — hatalar istisna olarak değil, error.code taşıyan ok:false olarak döner. Örnek, platformun İngilizce anahtar sözcük kümesini kullanır; yerelleştirilmiş karşılıkları (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) aynı şekilde çalışır.

Akaryakıt fiyatları kaynağında günde bir kez değişir; bu yüzden günde bir ya da iki kez çalışan zamanlanmış bir görev yeterlidir ve ücretsiz Explorer kotasının çok altında kalır. Canlı kuyruk verileri (queue, multi, border) birkaç dakikada bir değişir — bunları kendi programınızla sorgulayın ve döngü yerine multi ile tek istekte 5 sınır kapısına kadar okuyun.

MCP Sunucusu

REST yerine araç çağırmayı mı tercih ediyorsunuz? Bu API'nin güvenli, salt okunur bir alt kümesini MCP araçları olarak sunan gerçek bir MCP sunucusu (Streamable HTTP taşıması) çalıştırıyoruz — aynı API anahtarı, aynı kota, sadece farklı bir taşıma.

Endpoint: https://nakordoni.eu/mcp · Server card: /.well-known/mcp/server-card.json

get_api_status      — no key required
list_checkpoints     — country, lang
get_border_queue     — origin, destination, crossing_type, lang
get_live_queue       — ppid, lang
get_queue_forecast   — ppid, prediction_steps

İstemci yapılandırması (Claude Desktop / Claude Code):

{
  "mcpServers": {
    "nakordoni": {
      "url": "https://nakordoni.eu/mcp",
      "headers": { "Authorization": "Bearer NKD-DEV-XXXX-XXXX-XXXX" }
    }
  }
}

Ürünler

Tam referansı, parametreleri, sürümleri ve canlı sanal alanı için bir uç nokta seçin.

Standart standart veri kotasını kullanır  ·  Ağır tahmin ve istatistik kotasından çeker — bkz. Kotalar

Sınır Kuyrukları

Tahminler ve İstatistikler

Yakıt ve Konumlar

Seyahat Planlaması

Sürücüler ve Yollar

Your Fleet (NakBus Live)

Yapay Zeka Asistanı

Geçmiş veri dışa aktarımı

Onaylanmış geliştiriciler, en fazla 5 sınır kapısı için saatlik ortalaması alınmış, yayımlanmış sınır kuyruğu geçmişini (90 güne kadar kayan pencere) gzip'lenmiş CSV, NDJSON veya JSON olarak indirebilir. Bu yalnızca portala özgü bir özelliktir — bir API uç noktası DEĞİLDİR; dışa aktarımları hesabınızdaki "Veri dışa aktarma" sekmesinde oluşturur ve indirirsiniz.

Erişim talep üzerine verilir: hangi sınır kapılarını, hangi zaman aralığını ve verileri ne amaçla kullanacağınızı belirten bir Veri talebi açın. Onaylandıktan sonra hesabınızda Veri dışa aktarma sekmesi görünür. Varsayılan sınır: günde 1 dışa aktarma, her biri en fazla 5 sınır kapısı — artırmamızı isteyin.

Alanlar — sınır kapısı ve UTC saati başına bir satır

Veriler yalnızca yayımlanmış olanlardır ve dışa aktarımdan önce anomali / veri kalitesi kontrollerimizden geçer (ham rapor verisi yok). Tüm zaman damgaları UTC'dir. Dosyalar 10 gün saklanır.

Kaynak doğrulama: her dosya, başlığına imzalı bir parmak izi (sha256 + HMAC) gömer; böylece herhangi bir kopyanın gerçek nakordoni.eu verisi olduğu sonradan doğrulanabilir ve değiştirilip değiştirilmediği kontrol edilebilir — indirildikten sonra bile.

# sha256: 3f9c…   # signature: e87b…
ppid,checkpoint_name,hour_utc,direction,vehicle_type,avg_queue_length,avg_wait_minutes,sample_count
id_10,Hrushiv,2026-06-12T02:00:00Z,UA->PL,car,11,,4

Neler oluşturabilirsiniz

Aynı veri ürünleri, nakordoni.eu üzerindeki görselleri oluşturur — haftalık tahmin grafikleri, saatlik kuyruk profilleri, canlı durum kartları. Tahmin ve istatistik API'lerinin içeriğinden bir tat:

Atıf

Explorer planı entegrasyonları, verinin görüntülendiği her yerde görünür bir "Data by nakordoni.eu" bağlantısı göstermelidir. Bu, ücretsiz planı ücretsiz tutar.

Tam kod

Bu parçayı olduğu gibi kopyalayın. Bağlantı dizinlenebilir kalmalıdır: arama motorlarının takip edebileceği düz bir HTML <a href> — rel="nofollow" veya rel="sponsored" EKLEMEYİN, yalnızca JavaScript ile oluşturmayın ve CSS ile gizlemeyin.

<a href="https://nakordoni.eu/" title="Border queues, forecasts &amp; statistics">Data by nakordoni.eu</a>

Kompakt küçük yazı varyantı (örn. bir grafik veya widget altında):

<p style="font-size:12px;margin:4px 0">
  Data by <a href="https://nakordoni.eu/">nakordoni.eu</a>
</p>

Kendi dil sürümünüze bağlantı verebilirsiniz, örn. https://nakordoni.eu/tr/ — nakordoni.eu'ya giden her dizinlenebilir bağlantı sayılır. "Data by nakordoni.eu" bağlantı metni İngilizce kalmalıdır.

Nereye yerleştirilmeli

• Veri bloğunun (tablo, grafik, widget, yanıt) hemen yanına veya altına — aynı ekranda, ek tıklama olmadan görünür.
• Verilerimizin göründüğü her sayfada veya uygulama ekranında — yalnızca "hakkında" sayfasında değil.
• Okunabilir boyut ve kontrast: en az ~11px, gizli değil, daraltılmış değil, arka plan renginde değil.
• HTML bağlantısı olmayan yerel mobil uygulamalar: veri ekranında "Data by nakordoni.eu" metnini gösterin ve tıklanabilir bağlantıyı bilgi ekranına koyun.

Kayıtta belirttiğiniz "verilerin kullanıldığı sayfada" atıfı düzenli olarak doğruluyoruz. Ücretsiz Explorer planında eksik veya dizinden çıkarılmış atıf önce hatırlatmaya, sonra anahtarın askıya alınmasına yol açar. Ücretli plandaki müşteriler atıfı atlayabilir.

Veri lisansı ve piyasalar

Your API key grants a licence to use our data in the countries you declared when you signed up, and only in those countries. We review every declaration before granting full access, because our data is our own product and we do not license it into markets without knowing where it will be published.

• Declare every country your site, app or product serves. You can change the list from your dashboard at any time; a change puts your account back into review.
• Until your markets are approved your key runs on reduced limits - half of the Starter plan allowance. This applies whatever plan you are on.
• İstediğiniz ülkelerin sadece bazılarını onaylayabiliriz. Onaylanan liste, talep edilen değil, lisansınızın kapsadığı ülkeleri belirler.
• Publishing or redistributing our data in a market you did not declare, or reselling it as a competing data feed, is a breach of these terms and can suspend your key without notice.
• Some plans are offered only in selected regions. Availability depends on the markets you declare.

Veri tazeliği

Verilerin güncelliği tarifenize bağlıdır. Yanıtın kendisinde herhangi bir işaret yoktur — tüm tarifeler aynı alanları, aynı türleri ve aynı yanıt yapısını döndürür.

• Ücretli tarifeler — Student, Starter, Pro ve Pro MAX: gecikmesiz, canlı telemetri.
• Ücretsiz Explorer tarifesi: son 15–30 dakikaya ait bir anlık görüntü. Kesin gecikme miktarı istekten isteğe değişir.

Gecikmeli yanıt asla bir hata ya da kota sorunu değildir — daha eski sayılar içeren eksiksiz ve geçerli bir yanıttır. İsteği yinelemek daha yeni veri getirmez.

Uygulamanız güncel veriye ihtiyaç duyuyorsa, ücretli tarifelerin tümü gerçek zamanlı telemetri döndürür.

Ücretsiz API anahtarınızı alın