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

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

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

Периодично проверяваме атрибуцията на "страницата за използване на данните", посочена при регистрация. Липсваща или деиндексирана атрибуция в плана Explorer води първо до напомняне, после до спиране на ключа. Клиентите на Pay As You Grow могат да пропуснат атрибуцията.

Вземете безплатния си API ключ