API документација

Аутентификација

Сваки захтев захтева ваш API кључ у заглављу Authorization (препоручено) или као параметар ?key=.

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

Формат одговора

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

Грешке враћају ok:false са error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) и HTTP статусом 401/403/404/429/500. Заглавља за ограничење брзине X-Devapi-Limit и X-Devapi-Remaining шаљу се са сваким мереним одговором.

Квоте

Дневни бројачи се ресетују у поноћ по UTC. Добијате имејл на 80% и 100% квоте.

Примери кода

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

Производи

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

Стандардни koristi standardnu kvotu podataka  ·  Тежак koristi kvotu prognoze i statistike — vidi Квоте

Редови на граници

Прогнозе и статистике

Гориво и локације

Планирање путовања

Возачи и путеви

ВИ асистент

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

Шта можете да изградите

Исти производи са подацима приказују визуелне елементе на nakordoni.eu — недељне графиконе прогноза, сатне профиле гужви, картице са статусом уживо. Кратак увид у то шта садрже API-ји за прогнозе и статистику:

Атрибуција

Интеграције по плану Explorer морају приказати видљиву везу „Data by nakordoni.eu“ свуда где се подаци приказују. То одржава бесплатан план бесплатним.

Тачан код

Копирајте овај фрагмент без измена. Линк мора остати индексабилан: обичан HTML <a href> који претраживачи могу да прате — НЕ додавајте rel="nofollow" или rel="sponsored", не рендерујте га само преко JavaScript-а и не скривајте га CSS-ом.

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

Компактна ситна варијанта (нпр. испод графикона или виџета):

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

Можете линковати ка својој језичкој верзији, нпр. https://nakordoni.eu/sr/ — рачуна се сваки индексабилан линк ка nakordoni.eu. Текст сидра "Data by nakordoni.eu" мора остати на енглеском.

Где га поставити

• Непосредно поред или испод блока података (табела, графикон, виџет, одговор) — на истом екрану, видљиво без додатних кликова.
• На свакој страници или екрану апликације где се појављују наши подаци — не само на страници "о нама".
• Читљива величина и контраст: најмање ~11px, не скривено, не склопљено, не у боји позадине.
• Нативне мобилне апликације без HTML линкова: прикажите текст "Data by nakordoni.eu" на екрану са подацима и поставите кликабилан линк на информативни екран.

Периодично проверавамо атрибуцију на "страници коришћења података" наведеној при регистрацији. Недостајућа или деиндексирана атрибуција у плану Explorer води прво до подсетника, затим до суспензије кључа. Клијенти Pay As You Grow могу изоставити атрибуцију.

Преузмите свој бесплатан API кључ