Dokumentácia API

Autentifikácia

Každá požiadavka potrebuje váš API kľúč v hlavičke Authorization (odporúčané) alebo ako parameter ?key=.

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

Obálka odpovede

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

Chyby vracajú ok:false s error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) a HTTP stavom 401/403/404/429/500. Hlavičky obmedzenia rýchlosti X-Devapi-Limit a X-Devapi-Remaining sa odosielajú pri každej meranej odpovedi.

Kvóty

Denné počítadlá sa resetujú o polnoci UTC. E-mail dostanete pri 80 % a 100 % kvóty.

Ukážky kódu

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

Produkty

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

Štandardný využíva štandardnú dátovú kvótu  ·  Ťažký využíva kvótu prognóz a štatistík — pozri Kvóty

Fronty na hranici

Predpovede a štatistiky

Palivo a lokality

Cestovné plánovanie

Vodiči a cesty

AI asistent

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

Čo môžete vytvoriť

Tie isté dátové produkty vykresľujú vizuály na nakordoni.eu — grafy týždenných predpovedí, hodinové profily radov, živé stavové karty. Ukážka toho, čo obsahujú API predpovedí a štatistík:

Uvedenie zdroja

Integrácie plánu Explorer musia zobrazovať viditeľný odkaz „Data by nakordoni.eu“ všade, kde sa údaje zobrazujú. Vďaka tomu zostáva bezplatný plán bezplatný.

Presný kód

Skopírujte tento úryvok bez zmien. Odkaz musí zostať indexovateľný: obyčajný HTML <a href>, ktorý môžu vyhľadávače nasledovať — NEPRIDÁVAJTE rel="nofollow" ani rel="sponsored", nevykresľujte ho len cez JavaScript a neskrývajte cez CSS.

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

Kompaktný drobný variant (napr. pod grafom alebo widgetom):

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

Môžete odkazovať na svoju jazykovú verziu, napr. https://nakordoni.eu/sk/ — počíta sa každý indexovateľný odkaz na nakordoni.eu. Text kotvy "Data by nakordoni.eu" musí zostať v angličtine.

Kde umiestniť

• Priamo vedľa alebo pod blokom dát (tabuľka, graf, widget, odpoveď) — na rovnakej obrazovke, viditeľné bez ďalších klikov.
• Na každej stránke alebo obrazovke aplikácie, kde sa zobrazujú naše dáta — nielen na stránke "o nás".
• Čitateľná veľkosť a kontrast: aspoň ~11px, neskryté, nezbalené, nie vo farbe pozadia.
• Natívne mobilné aplikácie bez HTML odkazov: zobrazte text "Data by nakordoni.eu" na obrazovke s dátami a klikateľný odkaz umiestnite na informačnú obrazovku.

Atribúciu pravidelne overujeme na "stránke použitia dát" uvedenej pri registrácii. Chýbajúca alebo deindexovaná atribúcia v pláne Explorer vedie najprv k pripomienke, potom k pozastaveniu kľúča. Zákazníci Pay As You Grow môžu atribúciu vynechať.

Získajte svoj bezplatný API kľúč