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 арқылы көрсетпеңіз және 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/kk/ — nakordoni.eu-ге кез келген индекстелетін сілтеме есептеледі. "Data by nakordoni.eu" анкор мәтіні ағылшынша қалуы керек.

Қайда орналастыру

• Деректер блогының (кесте, график, виджет, жауап) тікелей жанында немесе астында — сол экранда, қосымша басусыз көрінетін.
• Біздің деректер көрсетілетін әрбір бетте немесе қолданба экранында — тек "біз туралы" бетінде ғана емес.
• Оқылатын өлшем мен контраст: кемінде ~11px, жасырылмаған, жиналмаған, фон түсінде емес.
• HTML сілтемелері жоқ нативті мобильді қолданбалар: деректер экранында "Data by nakordoni.eu" мәтінін көрсетіңіз, басылатын сілтемені ақпарат экранына қойыңыз.

Тіркелу кезінде көрсетілген "деректер қолданылатын бетте" атрибуцияны мерзімді тексереміз. Explorer жоспарында атрибуцияның болмауы немесе деиндекстелуі алдымен еске салуға, кейін кілтті тоқтатуға әкеледі. Pay As You Grow клиенттері атрибуцияны қалдыра алады.

Тегін API кілтіңізді алыңыз