API Dokümantasyonu

HTTPS üzerinden REST + JSON. Tek temel URL, tek anahtar, öngörülebilir zarflar.

Temel URL	`https://nakordoni.eu/api/v1/data/`
Biçim	JSON, UTF-8
Kimlik doğrulama	`Authorization: Bearer NKD-DEV-…`
Sürümleme	Yol bazlı sürümleme (v1). Bozucu değişiklikler yalnızca yeni bir sürümle; v1 yanıtları kararlı kalır.

Bu sayfada

Kimlik doğrulama · Yanıt zarfı · Kotalar · Kod örnekleri · Ürünler · Neler oluşturabilirsiniz

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

	Explorer	Pay As You Grow
standart veri API'lerinde gün başına çağrı	1,000	50,000
tahmin ve istatistik API'lerinde gün başına çağrı	200	10,000
QPS	2	20

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, usage } = await res.json();
if (!ok) throw new Error(data?.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

Checkpoints Directory API

Directory of all monitored border checkpoints: IDs, names, countries, coordinates and status. Use it to discover ppid values for the other APIs.

GET https://nakordoni.eu/api/v1/data/checkpoints — kota sınıfı: cheap

Parametre	Açıklama
`country`	Filter by numeric country code (1=UA, 2=PL, 3=SK, 4=HU, 5=RO, 6=MD, 7=BY, 8=LT, 9=LV, …)
`lang`	Language for checkpoint names (default en)

curl "https://nakordoni.eu/api/v1/data/checkpoints" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Live Border Queue API

Real-time queue length, wait estimate and status for any monitored checkpoint, plus hourly/daily aggregates.

GET https://nakordoni.eu/api/v1/data/queue — kota sınıfı: heavy

Parametre	Açıklama
`ppid`	Checkpoint ID, e.g. id_13 (see /api/v1/data/checkpoints)
`section`	Data section (optional)
`origin`	Origin country code (optional)
`destination`	Destination country code (optional)

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

Checkpoint Hourly Statistics API

Hourly historical queue stats per checkpoint and date: 24 hourly values, daily avg/min/max, peak and quietest hours, day-over-day comparison.

GET https://nakordoni.eu/api/v1/data/stats — kota sınıfı: heavy

Parametre	Açıklama
`ppid`	Checkpoint ID
`date`	YYYY-MM-DD (default: yesterday)
`compare`	1 = include previous day + delta
`lang`	Language code (default uk)

curl "https://nakordoni.eu/api/v1/data/stats?ppid=id_15&date=2026-06-01&compare=1" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Queue Forecast API

ML ensemble forecast of queue levels: 24-hour and 7-day (168h) horizons with confidence bounds. The same model that powers nakordoni.eu predictions.

GET https://nakordoni.eu/api/v1/data/forecast — kota sınıfı: heavy

Parametre	Açıklama
`ppid`	Checkpoint ID
`prediction_steps`	24 (default) or 168 for 7-day

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

Checkpoint Alternatives API

Nearby alternative checkpoints on the same border with current queues and distance deltas.

GET https://nakordoni.eu/api/v1/data/alternatives — kota sınıfı: cheap

Parametre	Açıklama
`ppid`	Checkpoint ID
`lang`	Language code

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

Data Freshness API

When a checkpoint was last updated, by which source, and a freshness rating.

GET https://nakordoni.eu/api/v1/data/update-info — kota sınıfı: cheap

Parametre	Açıklama
`ppid`	Checkpoint ID
`lang`	Language code

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

EU Fuel Prices API

Average petrol/diesel/LPG prices across EU countries plus nearest stations, aggregated from official national sources.

GET https://nakordoni.eu/api/v1/data/fuel — kota sınıfı: cheap

Parametre	Açıklama
`country`	ISO country code (optional)
`lat`	Latitude (optional)
`lon`	Longitude (optional)
`lang`	Language code

curl "https://nakordoni.eu/api/v1/data/fuel?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Driver POIs API

Truck parkings (14k+), free showers, services and supermarkets across Europe with coordinates.

GET https://nakordoni.eu/api/v1/data/pois — kota sınıfı: cheap

Parametre	Açıklama
`type`	parking\|shower\|supermarket\|industrial
`lat`	Latitude
`lon`	Longitude
`radius`	Radius km

curl "https://nakordoni.eu/api/v1/data/pois?type=parking&lat=50.7&lon=23.9&radius=50" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Truck Driving Bans API

European truck driving restrictions by country and date, including seasonal and holiday bans.

GET https://nakordoni.eu/api/v1/data/truck-bans — kota sınıfı: cheap

Parametre	Açıklama
`country`	ISO country code (optional)
`date`	YYYY-MM-DD (optional)

curl "https://nakordoni.eu/api/v1/data/truck-bans?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Trading Sundays API

Sunday retail-opening regulations and upcoming trading Sundays per regulated EU country.

GET https://nakordoni.eu/api/v1/data/trading-sundays — kota sınıfı: cheap

Parametre	Açıklama
`country`	ISO country code (optional)

curl "https://nakordoni.eu/api/v1/data/trading-sundays?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Border Weather API Yakında

Current conditions and road warnings at border checkpoints. (Coming soon)

GET https://nakordoni.eu/api/v1/data/weather — kota sınıfı: cheap

Parametre	Açıklama
`ppid`	Checkpoint ID

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

Bus Carrier Border Stats API

Border-crossing performance per bus carrier: crossings, average/median/min/max wait minutes — built from our own plate-matched crossing records.

GET https://nakordoni.eu/api/v1/data/bus-carriers — kota sınıfı: cheap

Parametre	Açıklama
`ppid`	Checkpoint ID or "all" for aggregated
`days`	Period 1-90 (default 30)
`min_crossings`	Minimum crossings to include a carrier (default 3)
`limit`	Max carriers returned (default 20)

curl "https://nakordoni.eu/api/v1/data/bus-carriers?ppid=all&days=30" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Road Conditions API

Approved road condition reports near borders and on major corridors: potholes, roadworks, closures, ice, hazards — combining driver reports with automatic accelerometer detections from our navigation app.

GET https://nakordoni.eu/api/v1/data/road-conditions — kota sınıfı: cheap

Parametre	Açıklama
`country`	ISO country code (optional)
`condition_type`	pothole\|speed_bump\|roadwork\|closure\|hazard\|ice\|… (optional)
`severity`	low\|moderate\|major\|critical (optional)
`lat`	Latitude (optional)
`lng`	Longitude (optional)
`radius`	Radius km (default 50)
`limit`	Max results (default 100, cap 500)

curl "https://nakordoni.eu/api/v1/data/road-conditions?country=UA&severity=major" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Border AI Assistant API

Ask our production AI assistant any border-crossing question (queues, forecasts, rules, fuel, routes) and get the same grounded answer that powers the nakordoni.eu widget — in 24 languages. Already used in production by yaknakordoni.com.ua.

GET https://nakordoni.eu/api/v1/data/assistant — kota sınıfı: heavy

Parametre	Açıklama
`q`	The question (plain text)
`lang`	Answer language (default en)
`ppid`	Checkpoint context, e.g. id_13 (optional)

curl "https://nakordoni.eu/api/v1/data/assistant?q=How long is the queue at Krakovets now?&lang=en&ppid=id_13" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Road Quality API Yakında

Road roughness scores per corridor computed from anonymized accelerometer telemetry of real drives: roughness index 0-100, pothole density per km, rough-corridor clusters with coordinates. (Coming soon)

GET https://nakordoni.eu/api/v1/data/road-quality — kota sınıfı: heavy

Parametre	Açıklama
`bbox`	Bounding box
`corridor`	Route corridor

curl "https://nakordoni.eu/api/v1/data/road-quality?bbox=22.5,48.2,24.5,50.5" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

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:

7-day border queue forecast chart built from the Forecast API — Haftalık tahmin + en yoğun günün saatlik profili — Forecast API (prediction_steps=168 / 24)

Hourly queue statistics chart built from the Statistics API — Sınır kapısı bazlı saatlik kuyruk grafiği — Statistics API (stats?ppid=…&compare=1)

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.

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