Dokumentace API

Autentizace

Každý požadavek potřebuje váš API klíč v hlavičce Authorization (doporučeno) nebo jako parametr ?key=.

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

Obálka odpovědi

{
  "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 vracejí 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 stavem 401/403/404/429/500. Hlavičky omezení rychlosti X-Devapi-Limit a X-Devapi-Remaining se odesílají u každé měřené odpovědi.

Kvóty

Denní čítače se resetují o půlnoci UTC. E-mail dostanete při 80 % a 100 % kvóty.

Ukázky 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.

Standardní čerpá ze standardní datové kvóty  ·  Těžký čerpá z kvóty prognóz a statistik — viz Kvóty

Fronty na hranici

Předpovědi a statistiky

Palivo a lokace

Cestovní plánování

Řidiči a silnice

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

Co můžete vytvořit

Tytéž datové produkty vykreslují vizuály na nakordoni.eu — grafy týdenních předpovědí, hodinové profily front, živé stavové karty. Ukázka toho, co obsahují API předpovědí a statistik:

Uvedení zdroje

Integrace plánu Explorer musí zobrazovat viditelný odkaz „Data by nakordoni.eu“ všude, kde se data zobrazují. Díky tomu zůstává bezplatný plán bezplatný.

Přesný kód

Zkopírujte tento úryvek beze změn. Odkaz musí zůstat indexovatelný: obyčejné HTML <a href>, které mohou vyhledávače následovat — NEPŘIDÁVEJTE rel="nofollow" ani rel="sponsored", nevykreslujte jej pouze JavaScriptem a neskrývejte přes CSS.

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

Kompaktní drobná varianta (např. pod grafem nebo widgetem):

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

Můžete odkazovat na svou jazykovou verzi, např. https://nakordoni.eu/cs/ — počítá se každý indexovatelný odkaz na nakordoni.eu. Text kotvy "Data by nakordoni.eu" musí zůstat anglicky.

Kam umístit

• Přímo vedle nebo pod blokem dat (tabulka, graf, widget, odpověď) — na stejné obrazovce, viditelné bez dalších kliknutí.
• Na každé stránce nebo obrazovce aplikace, kde se naše data objevují — nejen na stránce "o nás".
• Čitelná velikost a kontrast: alespoň ~11px, neskryté, nesbalené, ne v barvě pozadí.
• Nativní mobilní aplikace bez HTML odkazů: zobrazte text "Data by nakordoni.eu" na obrazovce s daty a klikatelný odkaz umístěte na informační obrazovku.

Atribuci pravidelně ověřujeme na "stránce použití dat" uvedené při registraci. Chybějící nebo deindexovaná atribuce v plánu Explorer vede nejprve k připomínce, poté k pozastavení klíče. Zákazníci Pay As You Grow mohou atribuci vynechat.

Získejte svůj bezplatný API klíč