Documentación de la API

Autenticación

Cada solicitud necesita tu clave API en la cabecera Authorization (recomendado) o como parámetro ?key=.

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

Envelope de respuesta

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

Los errores devuelven ok:false con error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) y estado HTTP 401/403/404/429/500. Las cabeceras de límite de tasa X-Devapi-Limit y X-Devapi-Remaining se envían en cada respuesta medida.

Cuotas

Los contadores diarios se reinician a medianoche UTC. Recibes un correo al 80% y al 100% de la cuota.

Ejemplos de código

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

Productos

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

Estándar utiliza la cuota de datos estándar  ·  Pesado utiliza la cuota de pronósticos y estadísticas — ver Cuotas

Colas en frontera

Pronósticos y estadísticas

Combustible y ubicaciones

Planificación de viajes

Conductores y carreteras

Asistente de IA

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

Lo que puedes crear

Los mismos productos de datos generan los elementos visuales de nakordoni.eu — gráficos de previsión semanal, perfiles horarios de colas, tarjetas de estado en tiempo real. Una muestra de lo que contienen las API de previsiones y estadísticas:

Atribución

Las integraciones del plan Explorer deben mostrar un enlace visible "Data by nakordoni.eu" allí donde se muestren los datos. Es lo que mantiene gratis el plan gratuito.

El código exacto

Copie este fragmento tal cual. El enlace debe seguir siendo indexable: un <a href> HTML simple que los buscadores puedan seguir — NO añada rel="nofollow" ni rel="sponsored", no lo renderice solo con JavaScript ni lo oculte con CSS.

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

Variante compacta en letra pequeña (p. ej., bajo un gráfico o widget):

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

Puede enlazar a su versión de idioma, p. ej. https://nakordoni.eu/es/ — cuenta cualquier enlace indexable a nakordoni.eu. El texto ancla "Data by nakordoni.eu" debe permanecer en inglés.

Dónde colocarlo

• Directamente junto o debajo del bloque de datos (tabla, gráfico, widget, respuesta) — en la misma pantalla, visible sin clics adicionales.
• En cada página o pantalla de la app donde aparezcan nuestros datos — no solo en una página "acerca de".
• Tamaño y contraste legibles: al menos ~11px, no oculto, no plegado, no del color del fondo.
• Apps móviles nativas sin enlaces HTML: muestre el texto "Data by nakordoni.eu" en la pantalla de datos y ponga el enlace pulsable en la pantalla de información.

Verificamos periódicamente la atribución en la "página de uso de datos" indicada al registrarse. La atribución ausente o desindexada en el plan Explorer conlleva primero un recordatorio y luego la suspensión de la clave. Los clientes de Pay As You Grow pueden omitirla.

Consigue tu clave API gratuita