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

Excel (Power Query)

Power Query के बिल्ट-इन JSON कनेक्टर की मदद से लाइव कतार, पूर्वानुमान या ट्रक प्रतिबंध डेटा सीधे वर्कबुक में लाएं — बिना कोड के, शेड्यूल पर रीफ़्रेश होने वाला। यही Headers पैटर्न इस API के हर प्रोडक्ट के लिए काम करता है — बस URL बदलें।

Data → Get Data → From Other Sources → Blank Query, then Home → Advanced Editor and paste:

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v1/data/queue",
        [Query = [ppid = "id_13"], Headers = [Authorization = "Bearer " & ApiKey]])),
    data = Source[data],
    AsTable = Record.ToTable(data)
in
    AsTable

API कुंजी को M क्वेरी के अंदर रखें (Home → Advanced Editor), शीट सेल में नहीं — Power Query किसी दूसरी क्वेरी या सेल से बने वेब अनुरोध को ब्लॉक करता है ("Formula.Firewall"), जब तक कि गोपनीयता स्तर Organizational सेट न हो।

एक ही टेबल में कई बॉर्डर क्रॉसिंग (फ्लीट डैशबोर्ड) — e.g. every truck crossing UA→EU (crossing_type=9):

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v1/data/border/1/all/9",
        [Headers = [Authorization = "Bearer " & ApiKey]])),
    checkpoints = Source[data],
    AsTable = Table.FromRecords(checkpoints)
in
    AsTable

Excel में Data → Refresh All, या Power BI / Excel Online में शेड्यूल्ड रीफ़्रेश, डेटा को अप-टू-डेट रखता है — बिना पोलिंग कोड के।

ERP एकीकरण (BAS / BAF और 1C-परिवार के प्लेटफ़ॉर्म)

BAS / BAF और 1C-परिवार के अन्य प्लेटफ़ॉर्म इस API को सीधे एक निर्धारित कार्य (scheduled job) से कॉल कर सकते हैं — HTTPConnection और ReadJSON, बिना किसी मिडलवेयर या अतिरिक्त सेवा के। सबसे आम व्यवस्था EU ईंधन कीमतों वाले सूचना रजिस्टर को अद्यतन रखती है।

सूचना रजिस्टर को ताज़ा करना (ईंधन कीमतें, सभी देश एक ही कॉल में)

// Scheduled job — runs once a day
Connection = New HTTPConnection("nakordoni.eu", 443, , , , 30, New OpenSSLSecureConnection);

Headers = New Map;
Headers.Insert("Authorization", "Bearer NKD-DEV-XXXX-XXXX-XXXX");

Request  = New HTTPRequest("/api/v1/data/fuel", Headers);
Response = Connection.Get(Request);

Reader = New JSONReader;
Reader.SetString(Response.GetBodyAsString("UTF-8"));
Answer = ReadJSON(Reader, True);
Reader.Close();

If Answer["ok"] <> True Then
    // Answer["error"]["code"] says why; Answer["usage"] holds your quota state
    Return;
EndIf;

For Each Row In Answer["data"] Do
    Record = InformationRegisters.FuelPrices.CreateRecordManager();
    Record.Period   = CurrentSessionDate();
    Record.Country  = Row["country"];    // "PL", "DE", "SK", "RO", ...
    Record.Diesel   = Row["diesel"];
    Record.Petrol   = Row["petrol"];
    Record.LPG      = Row["lpg"];
    Record.Currency = Row["currency"];
    Record.Write();
EndDo;

तीन बातें सही रखें: पोर्ट 443 पर New OpenSSLSecureConnection दें, वरना अनुरोध TLS पर ही विफल हो जाएगा; /api/v1/data/fuel को country पैरामीटर के बिना कॉल करें ताकि एक ही अनुरोध हर देश लौटाए, न कि प्रति देश एक कॉल; और data छूने से पहले ok जाँचें — विफलताएँ अपवाद के रूप में नहीं, error.code सहित ok:false के रूप में लौटती हैं। नमूने में प्लेटफ़ॉर्म का अंग्रेज़ी कीवर्ड सेट प्रयुक्त है; स्थानीयकृत समकक्ष (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) बिल्कुल वैसा ही व्यवहार करते हैं।

स्रोत पर ईंधन कीमतें दिन में एक बार बदलती हैं, इसलिए दिन में एक या दो बार चलने वाला निर्धारित कार्य पर्याप्त है और मुफ़्त Explorer कोटा के भीतर ही रहता है। लाइव कतार डेटा (queue, multi, border) हर कुछ मिनट में बदलता है — उसे अपनी अलग समय-सारणी पर पढ़ें और लूप के बजाय multi से एक ही अनुरोध में 5 तक चेकपॉइंट पढ़ें।

MCP सर्वर

REST के बजाय टूल-कॉलिंग पसंद करते हैं? हम एक वास्तविक MCP सर्वर (Streamable HTTP ट्रांसपोर्ट) चलाते हैं जो इस API के एक सुरक्षित, केवल-पढ़ने योग्य उपसमुच्चय को MCP टूल्स के रूप में उपलब्ध कराता है — वही API कुंजी, वही कोटा, बस एक अलग ट्रांसपोर्ट।

Endpoint: https://nakordoni.eu/mcp · Server card: /.well-known/mcp/server-card.json

get_api_status      — no key required
list_checkpoints     — country, lang
get_border_queue     — origin, destination, crossing_type, lang
get_live_queue       — ppid, lang
get_queue_forecast   — ppid, prediction_steps

क्लाइंट कॉन्फ़िगरेशन (Claude Desktop / Claude Code):

{
  "mcpServers": {
    "nakordoni": {
      "url": "https://nakordoni.eu/mcp",
      "headers": { "Authorization": "Bearer NKD-DEV-XXXX-XXXX-XXXX" }
    }
  }
}

उत्पाद

पूरा संदर्भ, पैरामीटर, संस्करण और लाइव सैंडबॉक्स देखने के लिए कोई एंडपॉइंट चुनें।

मानक मानक डेटा कोटा का उपयोग करता है  ·  भारी पूर्वानुमान और आँकड़ों की सीमा का उपयोग करता है — देखें कोटा

सीमा कतारें

पूर्वानुमान और आँकड़े

ईंधन और स्थान

यात्रा योजना

चालक और सड़कें

Your Fleet (NakBus Live)

एआई सहायक

ऐतिहासिक डेटा निर्यात

स्वीकृत डेवलपर 5 चौकियों तक का प्रति-घंटा औसत, प्रकाशित सीमा-कतार इतिहास (90 दिनों तक की चलती अवधि) gzip CSV, NDJSON या JSON में डाउनलोड कर सकते हैं। यह केवल पोर्टल की सुविधा है — कोई API एंडपॉइंट नहीं; निर्यात आप अपने खाते के "डेटा निर्यात" टैब से बनाते और डाउनलोड करते हैं।

पहुँच अनुरोध पर दी जाती है: एक Data टिकट खोलें और बताएँ कि कौन-सी चौकियाँ, कौन-सी समयावधि और किस उपयोग के लिए। स्वीकृति के बाद आपके खाते में "डेटा निर्यात" टैब दिखने लगता है। डिफ़ॉल्ट सीमा: 1 निर्यात/दिन, प्रत्येक में 5 चौकियाँ तक — बढ़ाने के लिए हमें कहें।

फ़ील्ड — प्रति चौकी प्रति UTC घंटा एक पंक्ति

केवल प्रकाशित डेटा निर्यात होता है और वह पहले हमारी विसंगति / डेटा-गुणवत्ता जाँच से गुज़रता है (कोई कच्चा प्रति-रिपोर्ट डेटा नहीं)। सभी टाइमस्टैम्प UTC में हैं। फ़ाइलें 10 दिन रखी जाती हैं।

उद्गम: हर फ़ाइल के हेडर में एक हस्ताक्षरित फ़िंगरप्रिंट (sha256 + HMAC) अंतर्निहित होता है, ताकि किसी भी प्रति की बाद में पुष्टि की जा सके कि वह असली nakordoni.eu डेटा है और उसमें छेड़छाड़ नहीं हुई — डाउनलोड के बाद भी।

# 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 प्लान में गायब या डी-इंडेक्स एट्रिब्यूशन पहले अनुस्मारक, फिर कुंजी निलंबन की ओर ले जाता है। सशुल्क योजना वाले ग्राहक एट्रिब्यूशन छोड़ सकते हैं।

डेटा लाइसेंस और बाज़ार

Your API key grants a licence to use our data in the countries you declared when you signed up, and only in those countries. We review every declaration before granting full access, because our data is our own product and we do not license it into markets without knowing where it will be published.

• Declare every country your site, app or product serves. You can change the list from your dashboard at any time; a change puts your account back into review.
• Until your markets are approved your key runs on reduced limits - half of the Starter plan allowance. This applies whatever plan you are on.
• हम केवल उन देशों में से कुछ को ही अनुमोदित कर सकते हैं जिन्हें आपने अनुरोध किया है। स्वीकृत सूची, अनुरोधित नहीं, यह निर्धारित करती है कि आपका लाइसेंस किन देशों को कवर करता है।
• Publishing or redistributing our data in a market you did not declare, or reselling it as a competing data feed, is a breach of these terms and can suspend your key without notice.
• Some plans are offered only in selected regions. Availability depends on the markets you declare.

डेटा ताज़गी

आपका डेटा कितना ताज़ा है, यह आपके प्लान पर निर्भर करता है। रिस्पॉन्स में इसका कोई संकेतक नहीं होता — हर प्लान वही फ़ील्ड, वही टाइप और वही रिस्पॉन्स संरचना लौटाता है।

• सशुल्क प्लान — Student, Starter, Pro और Pro MAX: बिना देरी के लाइव टेलीमेट्री।
• निःशुल्क Explorer प्लान: पिछले 15 से 30 मिनट का स्नैपशॉट। सटीक अंतर हर अनुरोध में बदलता रहता है।

विलंबित रिस्पॉन्स कभी त्रुटि नहीं होता और न ही कोटा की समस्या — यह पुराने आंकड़ों वाला पूर्ण और वैध रिस्पॉन्स है। दोबारा अनुरोध करने पर नया डेटा नहीं मिलेगा।

यदि आपके ऐप्लिकेशन को वर्तमान डेटा चाहिए, तो कोई भी सशुल्क प्लान रीयल-टाइम टेलीमेट्री लौटाता है।

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