Documentation de l'API

REST + JSON sur HTTPS. Une URL de base, une clé, des enveloppes prévisibles.

URL de base	`https://nakordoni.eu/api/v1/data/`
Format	JSON, UTF-8
Auth	`Authorization: Bearer NKD-DEV-…`
Versionnage	Versionné par chemin (v1). Les changements incompatibles uniquement avec une nouvelle version ; les réponses v1 restent stables.

Sur cette page

Authentification · Enveloppe de réponse · Quotas · Exemples de code · Produits · Attribution · Ce que vous pouvez créer

Authentification

Chaque requête nécessite votre clé API dans l'en-tête Authorization (recommandé) ou en tant que paramètre ?key=.

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

Enveloppe de réponse

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

Les erreurs renvoient ok:false avec error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, bad_request, internal_error) et un statut HTTP 401/403/404/429/500. Les en-têtes de limitation de débit X-Devapi-Limit et X-Devapi-Remaining sont envoyés à chaque réponse facturée.

Quotas

	Explorer	Pay As You Grow
appels/jour sur les API de données standard	1,000	50,000
appels/jour sur les API de prévisions et de statistiques	200	10,000
QPS	2	20

Les compteurs quotidiens sont réinitialisés à minuit UTC. Vous recevez un e-mail à 80 % et à 100 % du quota.

Exemples de code

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, usage } = await res.json();
if (!ok) throw new Error(data?.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"])

Produits

Statut API

État en temps réel de chaque produit Developer API : en ligne / dégradé / hors ligne, latence de réponse et heure de dernière vérification. Public — aucune clé API requise.

GET https://nakordoni.eu/api/v1/data/status — classe de quota: cheap

curl "https://nakordoni.eu/api/v1/data/status" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Annuaire des Points de Passage Online

Annuaire de tous les points de passage frontaliers surveillés : identifiants, noms, pays, coordonnées et statut. Utilisez-le pour découvrir les valeurs ppid pour les autres API.

GET https://nakordoni.eu/api/v1/data/checkpoints — classe de quota: cheap

Paramètre	Description
`country`	Filtrer par code pays numérique (1=UA, 2=PL, 3=SK, 4=HU, 5=RO, 6=MD, 7=BY, 8=LT, 9=LV, …)
`lang`	Langue des noms de points de passage (par défaut en)

curl "https://nakordoni.eu/api/v1/data/checkpoints" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API files d'attente frontalières Online

Tous les postes sur une frontière donnée + type de véhicule en un seul appel. Supporte destination unique, liste séparée par virgules ou "all". Résultats triés par longueur de file.

GET https://nakordoni.eu/api/v1/data/border/1/all/4 — classe de quota: heavy

Paramètre	Description
`origin`	Code pays d'origine (segment URL) : 1=Ukraine, 2=Pologne, 3=Slovaquie, 4=Hongrie, 5=Roumanie…
`destination`	Destination : code unique, liste par virgules ou "all" pour tous les voisins
`crossing_type`	Type de véhicule : 4=voiture, 5=voiture (taxfree), 6=bus, 7=piétons, 8=poids lourd <7.5t, 9=poids lourd
`lang`	Langue des noms de postes dans la réponse (défaut en)

curl "https://nakordoni.eu/api/v1/data/border/1/all/4" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API de recherche de postes frontières Online

Trouvez les PPID des postes frontières par nom dans n'importe quelle langue. Renvoie tous les PPID pour cet emplacement regroupés par type de véhicule. Jusqu'à 20 noms par requête.

GET https://nakordoni.eu/api/v1/data/search — classe de quota: cheap

Paramètre	Description
`name`	Nom ou liste par virgules (max 20), dans n'importe quelle langue
`lang`	Langue des noms retournés (défaut en)

curl "https://nakordoni.eu/api/v1/data/search?name=Krakovets,Shehyni&lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API File d'Attente Frontalière en Direct Online

Files d'attente en temps réel, estimation du temps d'attente et statut pour tout poste-frontière surveillé. Comprend un bloc snapshot : file actuelle (queue_now), temps d'attente prévu wait_min = tmin + file × tpercar, âge des données et source.

GET https://nakordoni.eu/api/v1/data/queue — classe de quota: heavy

Paramètre	Description
`ppid`	Identifiant du point de passage, par ex. id_13 (voir /api/v1/data/checkpoints)
`section`	Section de données (optionnel)
`origin`	Code du pays d'origine (optionnel)
`destination`	Code du pays de destination (optionnel)

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

API Statistiques Horaires des Points de Passage Online

Statistiques historiques horaires de file par point de passage et par date : 24 valeurs horaires, moyenne/min/max quotidiennes, heures de pointe et heures les plus calmes, comparaison d'un jour à l'autre.

GET https://nakordoni.eu/api/v1/data/stats — classe de quota: heavy

Paramètre	Description
`ppid`	Identifiant du point de passage
`date`	YYYY-MM-DD (par défaut : hier)
`compare`	1 = inclure le jour précédent + delta
`lang`	Code de langue (par défaut uk)

curl "https://nakordoni.eu/api/v1/data/stats?ppid=id_15&date=2026-06-01&compare=1" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API « Meilleur moment pour traverser » Online

Statistiques semaine type par checkpoint : matrice 7×24 jour-de-semaine×heure (médiane + bande p25/p75), jour le plus calme/chargé, meilleures/pires fenêtres de 2 heures.

GET https://nakordoni.eu/api/v1/data/day-stats — classe de quota: cheap

Paramètre	Description
`ppid`	ID du checkpoint
`lang`	Code langue

curl "https://nakordoni.eu/api/v1/data/day-stats?ppid=id_13&lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Prévision de File d'Attente Online

Prévision par ensemble ML des niveaux de file : horizons de 24 heures et 7 jours (168h) avec intervalles de confiance. Le même modèle qui alimente les prédictions de nakordoni.eu.

GET https://nakordoni.eu/api/v1/data/forecast — classe de quota: heavy

Paramètre	Description
`ppid`	Identifiant du point de passage
`prediction_steps`	24 (par défaut) ou 168 pour 7 jours

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

API Points de Passage Alternatifs Online

Points de passage alternatifs à proximité sur la même frontière avec les files actuelles et les écarts de distance.

GET https://nakordoni.eu/api/v1/data/alternatives — classe de quota: cheap

Paramètre	Description
`ppid`	Identifiant du point de passage
`lang`	Code de langue
`crossing_type`	Remplacer le filtre de type de véhicule — ex. 4=voiture, 6=bus, 7=piéton, 9=camion
`limit`	Nb max de résultats (défaut 5)

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

API Fraîcheur des Données Online

Quand un point de passage a été mis à jour pour la dernière fois, par quelle source, et une évaluation de fraîcheur.

GET https://nakordoni.eu/api/v1/data/update-info — classe de quota: cheap

Paramètre	Description
`ppid`	Identifiant du point de passage
`lang`	Code de langue

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

API Prix des Carburants UE Online

Prix moyens de l'essence/du diesel/du GPL dans les pays de l'UE ainsi que les stations les plus proches, agrégés à partir de sources nationales officielles.

GET https://nakordoni.eu/api/v1/data/fuel — classe de quota: cheap

Paramètre	Description
`country`	Code pays ISO (optionnel)
`lat`	Latitude (optionnel)
`lon`	Longitude (optionnel)
`lang`	Code de langue

curl "https://nakordoni.eu/api/v1/data/fuel?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Points d'Intérêt pour Conducteurs Online

Parkings poids lourds (14k+), douches gratuites, services et supermarchés à travers l'Europe avec coordonnées.

GET https://nakordoni.eu/api/v1/data/pois — classe de quota: cheap

Paramètre	Description
`type`	parking\|shower\|supermarket\|industrial
`lat`	Latitude
`lon`	Longitude
`radius`	Rayon km

curl "https://nakordoni.eu/api/v1/data/pois?type=parking&lat=50.7&lon=23.9&radius=50" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Interdictions de Circulation des Poids Lourds Online

Restrictions européennes de circulation des poids lourds par pays et par date, y compris les interdictions saisonnières et de jours fériés.

GET https://nakordoni.eu/api/v1/data/truck-bans — classe de quota: cheap

Paramètre	Description
`country`	Code pays ISO (optionnel)
`date`	YYYY-MM-DD (optionnel)

curl "https://nakordoni.eu/api/v1/data/truck-bans?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Dimanches Ouvrés Online

Réglementations sur l'ouverture des commerces le dimanche et prochains dimanches ouvrés par pays de l'UE réglementé.

GET https://nakordoni.eu/api/v1/data/trading-sundays — classe de quota: cheap

Paramètre	Description
`country`	Code pays ISO (optionnel)

curl "https://nakordoni.eu/api/v1/data/trading-sundays?country=PL" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Météo Frontalière Coming soon

Conditions actuelles et alertes routières aux points de passage frontaliers. (Bientôt disponible)

GET https://nakordoni.eu/api/v1/data/weather — classe de quota: cheap

Paramètre	Description
`ppid`	Identifiant du point de passage

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

API Statistiques Frontalières des Transporteurs en Bus Online

Performance de franchissement de frontière par transporteur en bus : passages, minutes d'attente moyenne/médiane/min/max — établies à partir de nos propres relevés de passages associés aux plaques.

GET https://nakordoni.eu/api/v1/data/bus-carriers — classe de quota: cheap

Paramètre	Description
`ppid`	Identifiant du point de passage ou "all" pour agrégé
`days`	Période 1-90 (par défaut 30)
`min_crossings`	Nombre minimum de passages pour inclure un transporteur (par défaut 3)
`limit`	Nombre maximum de transporteurs retournés (par défaut 20)

curl "https://nakordoni.eu/api/v1/data/bus-carriers?ppid=all&days=30" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API État des Routes Online

Signalements approuvés d'état des routes près des frontières et sur les grands corridors : nids-de-poule, travaux, fermetures, verglas, dangers — combinant les signalements des conducteurs avec les détections automatiques par accéléromètre de notre application de navigation.

GET https://nakordoni.eu/api/v1/data/road-conditions — classe de quota: cheap

Paramètre	Description
`country`	Code pays ISO (optionnel)
`condition_type`	pothole\|speed_bump\|roadwork\|closure\|hazard\|ice\|… (optionnel)
`severity`	low\|moderate\|major\|critical (optionnel)
`lat`	Latitude (optionnel)
`lng`	Longitude (optionnel)
`radius`	Rayon km (par défaut 50)
`limit`	Résultats maximum (par défaut 100, plafond 500)

curl "https://nakordoni.eu/api/v1/data/road-conditions?country=UA&severity=major" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Assistant IA Frontalier Online

Posez à notre assistant IA de production toute question sur le franchissement des frontières (files, prévisions, règles, carburant, itinéraires) et obtenez la même réponse fondée qui alimente le widget de nakordoni.eu — en 24 langues. Déjà utilisé en production par yaknakordoni.com.ua.

GET https://nakordoni.eu/api/v1/data/assistant — classe de quota: heavy

Paramètre	Description
`q`	La question (texte brut)
`lang`	Langue de la réponse (par défaut en)
`ppid`	Contexte du point de passage, par ex. id_13 (optionnel)

curl "https://nakordoni.eu/api/v1/data/assistant?q=How long is the queue at Krakovets now?&lang=en&ppid=id_13" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

API Qualité des Routes Coming soon

Scores de rugosité des routes par corridor calculés à partir de télémétrie d'accéléromètre anonymisée de trajets réels : indice de rugosité 0-100, densité de nids-de-poule par km, regroupements de corridors dégradés avec coordonnées. (Bientôt disponible)

GET https://nakordoni.eu/api/v1/data/road-quality — classe de quota: heavy

Paramètre	Description
`bbox`	Boîte englobante
`corridor`	Corridor d'itinéraire

curl "https://nakordoni.eu/api/v1/data/road-quality?bbox=22.5,48.2,24.5,50.5" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Ce que vous pouvez créer

Les mêmes produits de données génèrent les visuels de nakordoni.eu — graphiques de prévisions hebdomadaires, profils horaires des files, cartes de statut en temps réel. Un aperçu de ce que contiennent les API de prévisions et de statistiques :

7-day border queue forecast chart built from the Forecast API — Prévision hebdomadaire + profil horaire du jour le plus chargé — Forecast API (prediction_steps=168 / 24)

Hourly queue statistics chart built from the Statistics API — Graphique horaire des files par poste-frontière — Statistics API (stats?ppid=…&compare=1)

Attribution

Les intégrations du forfait Explorer doivent afficher un lien visible « Data by nakordoni.eu » partout où les données sont présentées. C'est ce qui maintient le forfait gratuit gratuit.

Le code exact

Copiez ce fragment tel quel. Le lien doit rester indexable : un simple <a href> HTML que les moteurs de recherche peuvent suivre — n'ajoutez PAS rel="nofollow" ni rel="sponsored", ne le générez pas uniquement via JavaScript et ne le masquez pas en CSS.

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

Variante compacte en petits caractères (p. ex. sous un graphique ou un widget) :

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

Vous pouvez pointer vers votre version linguistique, p. ex. https://nakordoni.eu/fr/ — tout lien indexable vers nakordoni.eu compte. Le texte d'ancre "Data by nakordoni.eu" doit rester en anglais.

Où le placer

Directement à côté ou sous le bloc de données (tableau, graphique, widget, réponse) — sur le même écran, visible sans clic supplémentaire.
Sur chaque page ou écran d'application où nos données apparaissent — pas seulement sur une page "à propos".
Taille et contraste lisibles : au moins ~11px, non masqué, non replié, pas de la couleur du fond.
Applications mobiles natives sans liens HTML : affichez le texte "Data by nakordoni.eu" sur l'écran des données et placez le lien cliquable sur l'écran d'informations.

Nous vérifions périodiquement l'attribution sur la "page d'utilisation des données" indiquée à l'inscription. Une attribution manquante ou désindexée sur le plan Explorer entraîne d'abord un rappel, puis la suspension de la clé. Les clients Pay As You Grow peuvent omettre l'attribution.

Obtenez votre clé API gratuite