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/hi/ — nakordoni.eu का कोई भी इंडेक्स योग्य लिंक मान्य है। एंकर टेक्स्ट "Data by nakordoni.eu" अंग्रेज़ी में ही रहना चाहिए।

कहां रखें

• डेटा ब्लॉक (टेबल, चार्ट, विजेट, उत्तर) के ठीक बगल में या नीचे — उसी स्क्रीन पर, अतिरिक्त क्लिक के बिना दिखाई दे।
• हर पेज या ऐप स्क्रीन पर जहां हमारा डेटा दिखता है — सिर्फ "हमारे बारे में" पेज पर नहीं।
• पठनीय आकार और कंट्रास्ट: कम से कम ~11px, छिपा नहीं, संक्षिप्त नहीं, बैकग्राउंड के रंग में नहीं।
• HTML लिंक के बिना नेटिव मोबाइल ऐप: डेटा स्क्रीन पर "Data by nakordoni.eu" टेक्स्ट दिखाएं और टैप करने योग्य लिंक जानकारी स्क्रीन पर रखें।

हम पंजीकरण के समय बताए गए "डेटा उपयोग पेज" पर समय-समय पर एट्रिब्यूशन सत्यापित करते हैं। Explorer प्लान में गायब या डी-इंडेक्स एट्रिब्यूशन पहले अनुस्मारक, फिर कुंजी निलंबन की ओर ले जाता है। Pay As You Grow ग्राहक एट्रिब्यूशन छोड़ सकते हैं।

अपनी निःशुल्क API कुंजी प्राप्त करें