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.

Стандарден се потпира на стандардната квота за податоци  ·  Тежок се користи од квотата за прогнози и статистика — видете Квоти

Гранични редици

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

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

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

Возачи и патишта

ИИ асистент

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 и не го криjте со 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/mk/ — се брои секој индексирлив линк до nakordoni.eu. Текстот на котвата "Data by nakordoni.eu" мора да остане на англиски.

Каде да се постави

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

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

Земете го вашиот бесплатен API клуч