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.

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"])

Ürünler

Pick an endpoint for its full reference, parameters, versions and a live sandbox.

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

Yapay Zeka Asistanı

Other

History data export

Approved developers can download hourly-averaged, published border-queue history for up to 5 checkpoints (rolling window up to 90 days) as gzipped CSV, NDJSON, or JSON. This is a portal-only feature — NOT an API endpoint; you build and download exports from the "Data export" tab in your account.

Access is granted on request: open a Data ticket telling us which checkpoints, the time window, and your intended use. Once approved, the Data export tab appears in your account. Default limit: 1 export/day, up to 5 checkpoints each — ask us to raise it.

Fields — one row per checkpoint per UTC hour

Data is published-only and passes our anomaly / data-quality checks before export (no raw per-report data). All timestamps are UTC. Files are kept for 10 days.

Provenance: every file embeds a signed fingerprint (sha256 + HMAC) in its header, so any copy can later be confirmed as genuine nakordoni.eu data and checked for tampering — even after download.

# 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. Explorer planında eksik veya dizinden çıkarılmış atıf önce hatırlatmaya, sonra anahtarın askıya alınmasına yol açar. Pay As You Grow müşterileri atıfı atlayabilir.

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