| बेस URL | https://nakordoni.eu/api/v1/data/ |
|---|---|
| प्रारूप | JSON, UTF-8 |
| प्रमाणीकरण | Authorization: Bearer NKD-DEV-… |
| संस्करण | पथ-आधारित और प्रति-endpoint वर्शनिंग: /api/v1/… स्थिर है और इसकी प्रतिक्रियाएँ कभी नहीं बदलतीं। उच्चतर वर्शन पथ (/api/v2/…, /api/v4/…) नया व्यवहार केवल उन endpoints के लिए देता है जो बदले हैं, और बाकी के लिए पारदर्शी रूप से निचले वर्शन पर लौट जाता है। हर उत्पाद वह उच्चतम वर्शन दिखाता है जिसका वह दस्तावेज़ीकरण करता है — उसी को लक्ष्य बनाएँ, इस नोट को नहीं। यदि आपकी कुंजी जिस संस्करण को कॉल करती है उसकी जगह कोई नया संस्करण ले लेता है, तो हम आपको ईमेल भेजते हैं और डेवलपर पोर्टल में सूचना दिखाते हैं — आपको इसे चेंजलॉग से पता नहीं लगाना पड़ता। |
इस पृष्ठ पर
प्रमाणीकरण
प्रत्येक अनुरोध को आपकी 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",
"terms": "https://nakordoni.eu/en/p/developer_api_terms",
"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, not_approved, bad_request, duplicate_request, market_not_allowed, internal_error, status_unavailable, timeout) और HTTP स्थिति 400/401/403/404/429/500/503/504 लौटाती हैं। दर-सीमा हेडर X-Devapi-Limit और X-Devapi-Remaining प्रत्येक मीटर्ड प्रतिक्रिया पर भेजे जाते हैं। ok:false ही निर्णायक है — असफल कॉल में data कभी न पढ़ें। usage ऑब्जेक्ट हर मीटर किए गए उत्पाद में मौजूद रहता है; /status सार्वजनिक और बिना मीटर का है, इसलिए वह usage नहीं लौटाता।
कोटा
| Explorer | |
|---|---|
| मानक डेटा API पर कॉल/दिन | 1,000 |
| पूर्वानुमान और आँकड़े API पर कॉल/दिन | 200 |
| ट्रक-रूट कॉल/दिन | 10 |
| QPS | 2 |
दैनिक काउंटर 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→PL (crossing_type=9; in v3 that one code covers both freight lanes):
let
ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v4/data/border/1/2/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" }
}
}
}
इंटीग्रेशन के लिए OAuth (Home Assistant और अन्य)
जिन इंटीग्रेशन के हर उपयोगकर्ता को अपनी कुंजी चाहिए (Home Assistant कस्टम इंटीग्रेशन, डेस्कटॉप और मोबाइल ऐप), वे कुंजी पेस्ट करवाने के बजाय उपयोगकर्ता को साइन इन करने दे सकते हैं। फ़्लो PKCE (S256) के साथ पब्लिक क्लाइंट के लिए OAuth 2.0 authorization code है — कोई client secret नहीं है। हम जो एक्सेस टोकन लौटाते हैं वह उपयोगकर्ता की अपनी NKD-DEV कुंजी है, जिसे आप अब तक की तरह ही Bearer हेडर में भेजते हैं।
क्लाइंट स्वयं नहीं बनते: इंटीग्रेशन पेज पर आवेदन करें, हम हर इंटीग्रेशन की समीक्षा हाथ से करते हैं और अनुमत रीडायरेक्ट URI के साथ client ID जारी करते हैं। स्वीकृत क्लाइंट से जारी कुंजियाँ उस इंटीग्रेशन के लिए स्वीकृत बाज़ारों के लिए तुरंत सक्रिय हो जाती हैं। इंटीग्रेशन क्लाइंट के लिए आवेदन करें →
GET https://api.nakordoni.dev/oauth/authorize | response_type=code, client_id, redirect_uri (किसी पंजीकृत URI से ठीक-ठीक मेल खाना चाहिए), state, code_challenge, code_challenge_method=S256 |
POST https://api.nakordoni.dev/oauth/token | grant_type=authorization_code, code, code_verifier, redirect_uri, client_id — या grant_type=refresh_token, refresh_token, client_id |
POST https://api.nakordoni.dev/oauth/revoke | token (refresh टोकन, या कुंजी स्वयं), client_id |
- ऑथराइज़ेशन कोड 60 सेकंड के लिए मान्य है, एक बार उपयोग योग्य है, और क्लाइंट, उपयोगकर्ता, रीडायरेक्ट URI तथा PKCE challenge से बँधा है।
- कुंजी केवल टोकन प्रतिक्रिया के बॉडी (access_token) में लौटाई जाती है — कभी URL में नहीं। इसे पासवर्ड की तरह सुरक्षित रखें।
- expires_in 30 दिन है; जब तक कुंजी सक्रिय है, रिफ़्रेश वही कुंजी लौटाता है। यदि उपयोगकर्ता कुंजी रद्द या पुनः जनरेट करता है, तो रिफ़्रेश invalid_grant के साथ विफल होता है और API कॉल 401 लौटाते हैं — पुनः प्रमाणीकरण शुरू करें।
- अनुरोध प्रति IP दर-सीमित हैं और प्रति क्लाइंट प्रतिदिन सीमित हैं; त्रुटियाँ RFC 6749 का पालन करती हैं (error, error_description)।
- हर उपयोगकर्ता को अधिकतम उसकी अपनी देश-सीमा मिलती है: यदि आपके इंटीग्रेशन में उपयोगकर्ता के खाली स्लॉट से अधिक देश हैं, तो वह उन्हें सहमति पेज पर चुनता है (पहले से चुनने के लिए /oauth/authorize पर markets=DE,AT भेजें)। दोनों token उत्तर markets_approved (उपयोगकर्ता के स्वीकृत देश), markets_allowed (उसकी सीमा; null = असीमित), markets_available (आपके वे देश जो उसके पास अभी नहीं हैं) और upgrade_url (जहाँ वह «अतिरिक्त देश» जोड़ता है) भी लौटाते हैं।
curl -X POST https://api.nakordoni.dev/oauth/token \
-d grant_type=authorization_code -d client_id=nkd_xxxxxxxxxxxxxxxxxxxxxxxx \
-d code=CODE -d code_verifier=VERIFIER \
-d redirect_uri=https://my.home-assistant.io/redirect/oauth
{"access_token":"NKD-DEV-XXXX-XXXX-XXXX","token_type":"Bearer","expires_in":2592000,
"refresh_token":"nkdrt_…","scope":"data","markets_approved":["DE"]}
Home Assistant
config_entry_oauth2_flow का उपयोग LocalOAuth2ImplementationWithPkce (client_secret खाली) और रीडायरेक्ट URI https://my.home-assistant.io/redirect/oauth के साथ करें, जो Home Assistant क्लाइंट के लिए पहले से पंजीकृत है। कुंजी को entry.data["token"]["access_token"] से पढ़ें और API को Authorization: Bearer के साथ कॉल करते रहें। API से 401 मिलने पर ConfigEntryAuthFailed उठाएँ ताकि Home Assistant पुनः प्रमाणीकरण की पेशकश करे।
from homeassistant.helpers import config_entry_oauth2_flow
impl = config_entry_oauth2_flow.LocalOAuth2ImplementationWithPkce(
hass, DOMAIN, client_id="nkd_xxxxxxxxxxxxxxxxxxxxxxxx",
authorize_url="https://api.nakordoni.dev/oauth/authorize",
token_url="https://api.nakordoni.dev/oauth/token",
)
config_entry_oauth2_flow.async_register_implementation(hass, DOMAIN, impl)
इंटीग्रेशन: बची हुई सीमाएँ दिखाएँ
GET /api/v2/account/usage — जिस कुंजी से आप कॉल करते हैं, उसके लिए अभी आपकी सीमाओं में से कितना बचा है: प्लान, प्रति सेकंड सीमा, और हर दैनिक कोटा वर्ग (cheap, heavy, route) के लिए सीमा, उपयोग, शेष और रीसेट समय (मध्यरात्रि UTC); साथ ही यह कुंजी जिन देशों को देखती है और प्लान कहाँ अपग्रेड करें। गिना नहीं जाता, प्रति कुंजी प्रति मिनट 30 कॉल।
इंटीग्रेशन (OAuth) कुंजियाँ GET /api/v2/account/usage को हमेशा कॉल कर सकती हैं, चाहे इंटीग्रेशन को कोई भी उत्पाद अनुमत हों। इसके आँकड़े X-Devapi-Limit और X-Devapi-Remaining हेडर से मेल खाते हैं; X-Devapi-Reset रीसेट समय Unix timestamp के रूप में देता है।
{"ok":true,"api_version":"v2","product":"account-usage","data":{
"plan":{"slug":"explorer","name":"Explorer"},"qps":2,
"quotas":{"cheap":{"limit":1000,"used":42,"remaining":958,"reset_at":"2026-10-17T00:00:00Z"},"heavy":{…},"route":{…}},
"markets":{"approved":["DE"],"allowed":1,"available":["AT"],"key_bound":true},
"pass":{"active":true,"expires_at":"2026-10-19T14:05:00Z","days_left":3},"upgrade_url":"https://nakordoni.eu/en/developers/billing",
"pass_url":"https://nakordoni.eu/en/developers/billing?section=trip-pass#trip-pass"}}
सीमा पूरी होने पर त्रुटि बताती है कि कहाँ जाना है: 429 quota_exceeded error.reset_at (UTC मध्यरात्रि) और error.upgrade_url भी लौटाता है; 403 market_not_allowed और 403 integration_product_not_allowed error.upgrade_url लौटाते हैं। इंटीग्रेशन कुंजियों को error.pass_url भी मिलता है (Trip Pass, नीचे)।
Home Assistant: /account/usage को अधिकतम हर 15 मिनट में पूछें और quotas.cheap.remaining से "बची हुई कॉल" सेंसर दिखाएँ। पूछताछ के बीच सामान्य कॉल से X-Devapi-Remaining पढ़ें। 429 quota_exceeded या 403 market_not_allowed पर error.upgrade_url के लिंक के साथ repair issue बनाएँ और reset_at तक कॉल रोक दें।
Trip Pass
इंटीग्रेशन उपयोगकर्ता बिलिंग पेज पर Trip Pass (1, 3, 7 या 14 दिन, एकमुश्त भुगतान) ख़रीद सकते हैं। सक्रिय रहने तक इंटीग्रेशन कुंजी को इंटीग्रेशन के सभी देश, प्रतिदिन अधिक ट्रक-रूट और डेटा कॉल तथा अधिक दर मिलती है; इंटीग्रेशन के उत्पाद, पूर्वानुमान सीमाएँ और डेटा विलंब नहीं बदलते। उसी खाते की डेवलपर कुंजियाँ कभी नहीं बढ़ाई जातीं।
इंटीग्रेशन कुंजियों के लिए account/usage pass: {active, expires_at, days_left} और pass_url (बिलिंग पेज का Trip Pass भाग) लौटाता है; 429 quota_exceeded और 403 market_not_allowed / integration_product_not_allowed में वही error.pass_url होता है। अन्य कुंजियों के लिए दोनों null होते हैं।
Country and vehicle-type codes
Border endpoints address countries and vehicle types by numeric id: /api/v1/data/border/{origin}/{destination}/{crossing_type}. destination also accepts a comma-separated list or the word all. The ids are stable and are the same in every product that takes an origin, a destination or a crossing_type.
Country ids
The border products accept the ids marked as origins below; the neighbours column is what destination=all expands to for that origin. Ids without neighbours are countries we name in responses but hold no crossings for yet. The Checkpoints Directory returns the origin, destination and crossing_type of every crossing we actually serve, so it stays the authoritative list.
| id | Country | Borders with (destination ids) |
|---|---|---|
1 |
यूक्रेन | 2, 3, 4, 5, 6, 7 |
2 |
पोलैंड | 1, 7, 18 |
3 |
स्लोवाकिया | 1 |
4 |
हंगरी | 1, 5, 13 |
5 |
रोमानिया | 1, 4, 6, 12, 13 |
6 |
मोल्दोवा | 1, 5 |
7 |
बेलारूस | 1, 2, 8, 9 |
8 |
लिथुआनिया | 7 |
9 |
लातविया | 7 |
11 |
स्लोवेनिया | 16, 20 |
12 |
बुल्गारिया | 5, 13, 14, 15, 19 |
13 |
सर्बिया | 4, 5, 12, 15, 16, 17, 22, 23 |
14 |
तुर्की | 12, 19 |
15 |
उत्तरी मैसेडोनिया | 12, 13, 19, 21, 23 |
16 |
क्रोएशिया | 11, 13, 17, 22 |
17 |
बोस्निया और हर्ज़ेगोविना | 13, 16, 22 |
18 |
जर्मनी | 2 |
19 |
यूनान | 12, 14, 15, 21 |
20 |
इटली | 11 |
21 |
अल्बानिया | 15, 19, 22, 23 |
22 |
मोंटेनेग्रो | 13, 16, 17, 21, 23 |
23 |
कोसोवो | 13, 15, 21, 22 |
24 |
ऑस्ट्रिया | — |
25 |
चेकिया | — |
26 |
फ्रांस | — |
27 |
स्पेन | — |
28 |
यूनाइटेड किंगडम | — |
29 |
नीदरलैंड | — |
30 |
बेल्जियम | — |
31 |
पुर्तगाल | — |
33 |
एस्टोनिया | — |
34 |
स्विट्ज़रलैंड | — |
35 |
डेनमार्क | — |
36 |
फ़िनलैंड | — |
37 |
लक्जमबर्ग | — |
38 |
नॉर्वे | — |
39 |
स्वीडन | — |
Vehicle types (crossing_type)
| id | Vehicle type | Accepted by /border/ |
|---|---|---|
4 |
कार | ✔ |
5 |
कार। टैक्स फ्री | ✔ |
6 |
बस | ✔ |
7 |
पैदल यात्री | ✔ |
8 |
माल परिवहन | ✔ |
9 |
7.5 टन तक माल परिवहन | ✔ |
10 |
फेरी क्रॉसिंग - कार | — |
11 |
फेरी क्रॉसिंग - बस | — |
12 |
फेरी क्रॉसिंग - पैदल यात्री | — |
13 |
फेरी क्रॉसिंग - माल परिवहन | — |
14 |
3.5 टन तक माल परिवहन | — |
The label in this table is the crossing_type_label the API returns with every response, in the language you request. Types outside the accepted list belong to crossings the directory carries but the border products do not answer for — ferry (10-13), freight up to 3.5 t (14) and rail (15) — and asking for one returns 400, not an empty result. Read crossing_type from the Checkpoints Directory rather than assuming: a crossing returns data only for the types it actually has.
उत्पाद
पूरा संदर्भ, पैरामीटर, संस्करण और लाइव सैंडबॉक्स देखने के लिए कोई एंडपॉइंट चुनें।
मानक मानक डेटा कोटा का उपयोग करता है · भारी पूर्वानुमान और आँकड़ों की सीमा का उपयोग करता है — देखें कोटा · ट्रक रूट अपने अलग ट्रक-रूट कोटा से कटता है — देखें कोटा
सीमा कतारें
हर Developer API उत्पाद की लाइव स्थिति: ऑनलाइन / खराब / ऑफलाइन, प्रतिक्रिया विलंब और अंतिम जाँच का समय। सार्वजनिक — API कुंजी की …
सभी निगरानी किए गए सीमा चेकपॉइंट की निर्देशिका: आईडी, नाम, देश, निर्देशांक और स्थिति। अन्य API के लिए ppid मान खोजने के लिए इसका …
एक कॉल में दी गई सीमा पर सभी क्रॉसिंग + वाहन प्रकार। एकल गंतव्य, अल्पविराम-पृथक सूची या "all" समर्थित। परिणाम कतार के क्रम में सॉ…
किसी भी भाषा में नाम से सीमा चौकी PPID खोजें। वाहन प्रकार के अनुसार समूहीकृत सभी PPID लौटाता है। प्रति अनुरोध 20 नाम तक।
किसी भी निगरानी चौकी के लिए वास्तविक समय की कतारें, प्रतीक्षा समय का अनुमान और स्थिति। snapshot ब्लॉक शामिल: वर्तमान कतार (queue_…
Wait time adjusted for live traffic flow and weather, with a full breakdown of each adjustment, plus the same wait_status/trend f…
एक ही अनुरोध में अधिकतम 5 चेकपॉइंट के लिए लाइव कतार स्थिति और डेटा ताज़गी प्राप्त करें। कोटा ⌈(N PPID × उप-उत्पाद) / 2⌉ के रूप मे…
उसी सीमा पर निकटवर्ती वैकल्पिक चेकपॉइंट वर्तमान कतारों और दूरी अंतरों के साथ।
चेकपॉइंट अंतिम बार कब, किस स्रोत द्वारा अद्यतन किया गया, और एक ताज़गी रेटिंग।
पूर्वानुमान और आँकड़े
कतार स्तरों का ML समूह पूर्वानुमान: विश्वास सीमाओं के साथ 24-घंटे और 7-दिन (168घं) क्षितिज। वही मॉडल जो nakordoni.eu पूर्वानुमानो…
प्रति चेकपॉइंट और तिथि के अनुसार प्रति घंटा ऐतिहासिक कतार सांख्यिकी: 24 घंटे के मान, दैनिक औसत/न्यूनतम/अधिकतम, चरम और सबसे शांत घ…
चेकपॉइंट के लिए विशिष्ट-सप्ताह आँकड़े: 7×24 मैट्रिक्स सप्ताह-दिन×घंटा (माध्यिका + p25/p75 बैंड), सबसे शांत/व्यस्त दिन, सर्वश्रेष्…
ईंधन और स्थान
EU देशों में ईंधन की कीमतें — country औसत, निर्देशांक के अनुसार निकटतम स्टेशन, या सीमा जांच चौकी के पास के स्टेशन। आधिकारिक राष्ट…
शहर के अनुसार ईंधन की कीमतें: सबसे सस्ता स्टेशन और शीर्ष 5 का औसत.
किसी बिंदु या शहर के सबसे नज़दीकी पेट्रोल स्टेशन, प्रत्येक ईंधन प्रकार के मौजूदा दामों सहित, दूरी के अनुसार क्रमबद्ध। station-lev…
किसी बिंदु या शहर के आसपास के सबसे सस्ते पेट्रोल स्टेशन, चुने गए ईंधन प्रकार के दाम के अनुसार क्रमबद्ध (बराबरी होने पर सबसे नज़दी…
यूरोप के किसी भी बिंदु के लिए उपलब्ध सर्वोत्तम fuel दाम, एक तीन-स्तरीय फ़ॉलबैक सीढ़ी से हल किया जाता है ताकि जहाँ भी हमारे पास को…
हर fuel product के पीछे की नामकरण तालिका: हमारी canonical ग्रेड शब्दावली (diesel, premdiesel, truckdiesel, hvo, petrol92, e5, e10…
पूरे यूरोप में निर्देशांक सहित ट्रक पार्किंग (14k+), मुफ़्त शावर, सेवाएं और सुपरमार्केट। परिणाम distance_km के साथ निकटतम-पहले क्…
किसी बिंदु या city के सबसे नज़दीकी ट्रक पार्किंग, Autohöfe और ट्रक स्टॉप — distance_km, नाम, निर्देशांक और country के साथ दूरी के…
किसी बिंदु या city के सबसे नज़दीकी सुपरमार्केट और किराना दुकानें — distance_km, नाम, निर्देशांक और country के साथ दूरी के अनुसार …
किसी बिंदु या city के सबसे नज़दीकी ड्राइवरों के लिए मुफ़्त शावर — distance_km, नाम, निर्देशांक और country के साथ दूरी के अनुसार क…
किसी बिंदु या city के सबसे नज़दीकी ड्राइवर-अनुकूल रेस्टोरेंट — distance_km, नाम, निर्देशांक और country के साथ दूरी के अनुसार क्रम…
किसी बिंदु या city के सबसे नज़दीकी औद्योगिक और लॉजिस्टिक्स क्षेत्र (पूरे यूरोप में 3k+ से अधिक) — distance_km, नाम, निर्देशांक और…
PLN, CZK, HUF, USD, GBP, CHF, NOK और UAH के लिए EUR-आधारित विनिमय दरें, स्रोत Frankfurter (ECB), कैश 6 घंटे। कोई पैरामीटर नहीं — …
मुद्रा विनिमय केंद्र
पोलैंड के वे शहर जहाँ हम मुद्रा विनिमय केंद्र (kantors) सूचीबद्ध करते हैं, हर शहर में केंद्रों की संख्या और उनमें से कितने अभी दर…
पोलैंड के मुद्रा विनिमय केंद्रों (kantors) की निर्देशिका: नाम, पता, निर्देशांक, खुलने का समय, फ़ोन, वेबसाइट और क्या केंद्र थोक दर…
एक विनिमय केंद्र, PLN के मुकाबले उसकी वर्तमान खरीद और बिक्री दरों के साथ। खुदरा और थोक दरें अलग-अलग लौटाई जाती हैं: थोक दर केवल m…
किसी एक शहर में अभी एक मुद्रा को PLN में कहाँ खरीदें या बेचें: सर्वश्रेष्ठ खुदरा दरों वाले केंद्र, रैंक के साथ, आधिकारिक NBP संदर…
PLN के मुकाबले एक मुद्रा की खुदरा दर का इतिहास, एक केंद्र के लिए या पूरे शहर के लिए (उसके केंद्रों में औसत और सर्वश्रेष्ठ दर), प्…
यात्रा योजना
सीमा पार यात्रा के लिए द्वार-से-द्वार योजना: मार्ग, उस पर पड़ने वाली सीमा चौकियाँ लाइव कतार या आपके पहुँचने के समय के पूर्वानुमान…
किसी मूल से सभी चेकपॉइंट के लिए यात्रा समय + सीमा कतार डेटा.
country और तारीख के अनुसार यूरोपीय ट्रक ड्राइविंग प्रतिबंध, जिनमें मौसमी और छुट्टी के प्रतिबंध शामिल हैं। प्रत्येक प्रतिबंध में उ…
प्रत्येक विनियमित EU देश के लिए रविवार खुदरा-उद्घाटन नियम और आगामी व्यापारिक रविवार।
यूरोपीय देशों के लिए आधिकारिक सार्वजनिक छुट्टियों का डेटा — तारीखें, स्थानीय नाम और प्रकार, प्रत्येक देश की संपूर्ण छुट्टियों की …
लॉजिस्टिक्स
चालक और सड़कें
सीमाओं के पास और प्रमुख गलियारों पर अनुमोदित सड़क स्थिति रिपोर्ट: गड्ढे, सड़क कार्य, बंदी, बर्फ, खतरे — ड्राइवर रिपोर्ट को हमारे …
क्या किसी country को हाईवे यात्रा के लिए विनयेट की आवश्यकता है, अवधि के अनुसार मौजूदा कीमतें और अधिक कहाँ पढ़ें — प्रति country य…
सड़क पर ड्राइवरों के लिए उपयोगी मोबाइल-ऑपरेटर की दुकानें और WiFi पॉइंट, किसी बिंदु या city से distance_km के साथ निकटतम-पहले।
प्रति बस वाहक सीमा-पार प्रदर्शन: पारगमन, औसत/माध्यिका/न्यूनतम/अधिकतम प्रतीक्षा मिनट — हमारे अपने प्लेट-मिलान पारगमन रिकॉर्ड से नि…
किसी चेकपॉइंट पर सड़क का ख़तरा एक ही 0–5 पैमाने पर: साफ़ सड़क, कोहरा, बर्फ़, बारिश, फिसलन या तेज़ हवा — आपकी भाषा में, गंभीरता, आ…
Air-raid alerts and airborne objects near ONE border crossing. Anchor on a checkpoint (ppid), a coordinate pair or a city and get…
Your Fleet (NakBus Live)
आपका अपना NakBus Live बेड़ा: आपकी कंपनी के नाम पंजीकृत हर वाहन, नंबर प्लेट, लेबल, निर्धारित मार्ग, सार्वजनिक मानचित्र फ़्लैग, स्थ…
आपकी बसें अभी ठीक कहाँ हैं — प्रत्येक सक्रिय वाहन के लिए एक पंक्ति, lat/lon, टाइमस्टैम्प और उसकी आयु, गति, दिशा और समय-सारणी विलं…
आपके अपने वाहनों का रिकॉर्ड किया गया GPS ट्रैक: एक समय-विंडो में संग्रहीत हर पोज़िशन बिंदु, कालानुक्रमिक क्रम में, गति, दिशा और स…
एआई सहायक
हमारे उत्पादन AI सहायक से कोई भी सीमा-पार प्रश्न पूछें (कतारें, पूर्वानुमान, नियम, ईंधन, मार्ग) और वही आधारित उत्तर प्राप्त करें …
आपका अपना AI असिस्टेंट, जो आपकी सामग्री और हमारे लाइव सीमा डेटा पर आधारित है। हमें अपनी markdown फ़ाइलें दें या वे पेज बताएँ जिन्…
अन्य
जिस कुंजी से आप कॉल करते हैं, उसके लिए अभी आपकी सीमाओं में से कितना बचा है: प्लान, प्रति सेकंड सीमा, और हर दैनिक कोटा वर्ग (cheap…
Pedestrian routes ranked by how much of the way lies in building and tree shade at the time of the walk (heat) or in sun (cold). …
Shade per H3 resolution-11 hex (about 25 m) for a small bounding box at a given time: share of open ground in building shade and …
Shade share and pavement temperature estimate of one walk for every 15-minute departure in the next hours, and the best window. P…
Places to cool a dog down near a point: safe water access on lake and river shores, bathing places, drinking water, forests, all-…
Cool spots for dogs along a walking route: every spot within the corridor with its position along the walk and the shade at the t…
Truck-accessible stops within 2 km of a route you already have: truck parkings shaded by trees (canopy share within 100 m), rest …
ऐतिहासिक डेटा निर्यात
स्वीकृत डेवलपर 5 चौकियों तक का प्रति-घंटा औसत, प्रकाशित सीमा-कतार इतिहास (90 दिनों तक की चलती अवधि) gzip CSV, NDJSON या JSON में डाउनलोड कर सकते हैं। यह केवल पोर्टल की सुविधा है — कोई API एंडपॉइंट नहीं; निर्यात आप अपने खाते के "डेटा निर्यात" टैब से बनाते और डाउनलोड करते हैं।
पहुँच अनुरोध पर दी जाती है: एक Data टिकट खोलें और बताएँ कि कौन-सी चौकियाँ, कौन-सी समयावधि और किस उपयोग के लिए। स्वीकृति के बाद आपके खाते में "डेटा निर्यात" टैब दिखने लगता है। डिफ़ॉल्ट सीमा: 1 निर्यात/दिन, प्रत्येक में 5 चौकियाँ तक — बढ़ाने के लिए हमें कहें।
फ़ील्ड — प्रति चौकी प्रति UTC घंटा एक पंक्ति
| पैरामीटर | विवरण |
|---|---|
ppid | चौकी की id |
checkpoint_name | चौकी का नाम |
hour_utc | घंटे का खंड, ISO-8601 UTC |
direction | उदा. UA->PL |
vehicle_type | कार / बस / ट्रक / पैदल यात्री |
avg_queue_length | प्रति घंटा औसत कतार लंबाई |
avg_wait_minutes | प्रति घंटा औसत प्रतीक्षा; जहाँ चौकी के लिए आधिकारिक प्रतीक्षा फ़ीड नहीं है वहाँ null |
sample_count | उस घंटे में प्रेक्षणों की संख्या |
केवल प्रकाशित डेटा निर्यात होता है और वह पहले हमारी विसंगति / डेटा-गुणवत्ता जाँच से गुज़रता है (कोई कच्चा प्रति-रिपोर्ट डेटा नहीं)। सभी टाइमस्टैम्प 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>, जिसे Google इंडेक्स और फॉलो कर सके — rel="nofollow", rel="sponsored" या rel="ugc" न जोड़ें और इसे CSS से न छिपाएँ। JavaScript से जोड़ा गया लिंक ठीक है, अगर वह Google द्वारा रेंडर किए गए पेज पर दिखता है (Developer API शर्तें v1.0, धारा 8.1)।
<a href="https://nakordoni.eu/" title="Border queues, forecasts & 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 की ओर कोई भी दृश्यमान सामान्य HTML लिंक मान्य है। एंकर टेक्स्ट "Data by nakordoni.eu" अंग्रेज़ी में ही रहना चाहिए।
कहां रखें
- डेटा ब्लॉक (टेबल, चार्ट, विजेट, उत्तर) के ठीक बगल में या नीचे — उसी स्क्रीन पर, अतिरिक्त क्लिक के बिना दिखाई दे।
- हर पेज या ऐप स्क्रीन पर जहां हमारा डेटा दिखता है — सिर्फ "हमारे बारे में" पेज पर नहीं।
- पठनीय आकार और कंट्रास्ट: कम से कम ~11px, छिपा नहीं, संक्षिप्त नहीं, बैकग्राउंड के रंग में नहीं।
- HTML लिंक के बिना नेटिव मोबाइल ऐप: डेटा स्क्रीन पर "Data by nakordoni.eu" टेक्स्ट दिखाएं और टैप करने योग्य लिंक जानकारी स्क्रीन पर रखें।
साइनअप के समय आपके द्वारा बताए गए "डेटा उपयोग वाले पृष्ठ" पर हम समय-समय पर एट्रिब्यूशन की जाँच करते हैं। नि:शुल्क Explorer प्लान पर एट्रिब्यूशन अनुपस्थित या छिपा होने पर पहले अनुस्मारक और फिर कुंजी निलंबन होता है। सशुल्क प्लान के ग्राहक एट्रिब्यूशन छोड़ सकते हैं।
जाँच लगभग हफ़्ते में एक बार हमारे जाँच बॉट द्वारा की जाती है, जिसके user agent में NakordoniComplianceBot/1.0 होता है। यह केवल आपके डेवलपर डैशबोर्ड में सूचीबद्ध पेज खोलता है, किसी अन्य लिंक पर नहीं जाता और इन पेजों के लिए robots.txt को नहीं मानता, क्योंकि आपने इन्हीं की जाँच के लिए कहा है। अगर बॉट सुरक्षा या फ़ायरवॉल अनजान क्रॉलर को रोकता है, तो इस user agent को अनुमति दें — अगर हम कोई पेज नहीं खोल पाए, तो हम टिकट के ज़रिए आपको लिखेंगे।
डेटा लाइसेंस और बाज़ार
आपकी API कुंजी केवल साइनअप के समय आपके द्वारा घोषित देशों में ही हमारे डेटा के उपयोग का लाइसेंस देती है। पूर्ण एक्सेस देने से पहले हम हर घोषणा की समीक्षा करते हैं, क्योंकि हमारा डेटा हमारा अपना उत्पाद है और हम यह जाने बिना कि यह कहाँ प्रकाशित होगा, इसे बाज़ारों में लाइसेंस नहीं देते।
- अपनी साइट, ऐप या उत्पाद द्वारा सेवा दिए जाने वाले हर देश को घोषित करें। आप किसी भी समय अपने डैशबोर्ड से सूची बदल सकते हैं; बदलाव आपके अकाउंट को फिर से समीक्षा में डाल देता है।
- जब तक आपके बाज़ार अनुमोदित नहीं होते, आपकी कुंजी सीमित लिमिट पर चलती है — Starter प्लान की सीमा का आधा। यह लागू होता है चाहे आप किसी भी प्लान पर हों।
- हम केवल उन देशों में से कुछ को ही अनुमोदित कर सकते हैं जिन्हें आपने अनुरोध किया है। स्वीकृत सूची, अनुरोधित नहीं, यह निर्धारित करती है कि आपका लाइसेंस किन देशों को कवर करता है।
- किसी अघोषित बाज़ार में हमारा डेटा प्रकाशित या पुनर्वितरित करना, या इसे प्रतिस्पर्धी डेटा फीड के रूप में पुनर्विक्रय करना इन शर्तों का उल्लंघन है और आपकी कुंजी को बिना सूचना के निलंबित कर सकता है।
- कुछ प्लान केवल चुनिंदा क्षेत्रों में ही उपलब्ध हैं। उपलब्धता आपके घोषित बाज़ारों पर निर्भर करती है।
- पूर्ण अनुबंध Developer API शर्तें है। ये इस सारांश पर वरीयता रखती हैं; कानूनी रूप से बाध्यकारी अंग्रेज़ी संस्करण है।
डेटा ताज़गी
आपका डेटा कितना ताज़ा है, यह आपके प्लान पर निर्भर करता है। रिस्पॉन्स में इसका कोई संकेतक नहीं होता — हर प्लान वही फ़ील्ड, वही टाइप और वही रिस्पॉन्स संरचना लौटाता है।
- सशुल्क प्लान — Student, Starter, Pro और Pro MAX: बिना देरी के लाइव टेलीमेट्री।
- निःशुल्क Explorer प्लान: पिछले 15 से 30 मिनट का स्नैपशॉट। सटीक अंतर हर अनुरोध में बदलता रहता है।
विलंबित रिस्पॉन्स कभी त्रुटि नहीं होता और न ही कोटा की समस्या — यह पुराने आंकड़ों वाला पूर्ण और वैध रिस्पॉन्स है। दोबारा अनुरोध करने पर नया डेटा नहीं मिलेगा।
यदि आपके ऐप्लिकेशन को वर्तमान डेटा चाहिए, तो कोई भी सशुल्क प्लान रीयल-टाइम टेलीमेट्री लौटाता है।
अपनी निःशुल्क API कुंजी प्राप्त करें
अपडेट किया गया