API sənədləri

Autentifikasiya

Hər sorğu API açarınızı Authorization başlığında (tövsiyə olunur) və ya ?key= parametri kimi tələb edir.

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

Cavab strukturu

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

Xətalar ok:false qaytarır, error.code ilə (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) və HTTP statusu 401/403/404/429/500. X-Devapi-Limit və X-Devapi-Remaining başlıqları hər ölçülən cavabla göndərilir.

Kvotalar

Günlük sayğaclar UTC gecə yarısı sıfırlanır. Kvotanın 80% və 100%-də e-poçt alırsınız.

Kod nümunələri

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

Məhsullar

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

Standart standart məlumat kvotasından istifadə edir  ·  Ağır proqnoz və statistika kvotasından istifadə edir — bax Kvotalar

Sərhəd növbələri

Proqnozlar və Statistika

Yanacaq və Yerlər

Səyahət Planlaması

Sürücülər və Yollar

AI Köməkçisi

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

Nə qura bilərsiniz

Eyni məlumat məhsulları nakordoni.eu-dakı vizualları yaradır — həftəlik proqnoz qrafikləri, saatlıq növbə profilləri, canlı status kartları. Proqnoz və statistika API-lərinin tərkibindən bir nümunə:

İstinad

Explorer planı inteqrasiyaları məlumatın göstərildiyi hər yerdə görünən "Data by nakordoni.eu" keçidi göstərməlidir. Pulsuz planı pulsuz saxlayan budur.

Dəqiq kod

Bu fraqmenti olduğu kimi kopyalayın. Keçid indekslənə bilən qalmalıdır: axtarış sistemlərinin izləyə biləcəyi sadə HTML <a href> — rel="nofollow" və ya rel="sponsored" ƏLAVƏ ETMƏYİN, yalnız JavaScript ilə göstərməyin və CSS ilə gizlətməyin.

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

Kompakt xırda variant (məs., qrafik və ya vidcet altında):

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

Öz dil versiyanıza keçid verə bilərsiniz, məs. https://nakordoni.eu/az/ — nakordoni.eu-ya istənilən indekslənə bilən keçid sayılır. "Data by nakordoni.eu" anker mətni ingiliscə qalmalıdır.

Haraya yerləşdirilməli

• Məlumat blokunun (cədvəl, qrafik, vidcet, cavab) dərhal yanında və ya altında — eyni ekranda, əlavə kliklər olmadan görünən.
• Məlumatlarımızın göründüyü hər səhifədə və ya tətbiq ekranında — yalnız "haqqımızda" səhifəsində deyil.
• Oxuna bilən ölçü və kontrast: ən azı ~11px, gizlədilməmiş, yığılmamış, fon rəngində deyil.
• HTML keçidləri olmayan nativ mobil tətbiqlər: məlumat ekranında "Data by nakordoni.eu" mətnini göstərin və kliklənə bilən keçidi məlumat ekranına qoyun.

Qeydiyyatda göstərdiyiniz "məlumatların istifadə olunduğu səhifədə" atribusiyanı vaxtaşırı yoxlayırıq. Explorer planında atribusiyanın olmaması və ya deindeksasiyası əvvəlcə xatırlatmaya, sonra açarın dayandırılmasına gətirir. Pay As You Grow müştəriləri atribusiyanı buraxa bilər.

Pulsuz API açarınızı əldə edin