सीमा मौसम स्थिति API Offline
किसी चेकपॉइंट पर सड़क का ख़तरा एक ही 0–5 पैमाने पर: साफ़ सड़क, कोहरा, बर्फ़, बारिश, फिसलन या तेज़ हवा — आपकी भाषा में, गंभीरता, आँकड़े की आयु और स्रोत के साथ: चालक या हमारा मॉडल।
GET https://nakordoni.eu/api/v1/data/weather
— कोटा श्रेणी: cheap
| पैरामीटर | विवरण |
|---|---|
ppid | चेकपॉइंट आईडी, उदाहरण के लिए id_13 (देखें /api/v1/data/checkpoints) |
lang | स्थिति और गंभीरता के नामों की भाषा (25 भाषाएँ; डिफ़ॉल्ट en) |
sources | all (डिफ़ॉल्ट) | community — केवल चालकों की रिपोर्ट | model — केवल हमारा वर्गीकरण |
max_age_minutes | किसी मार्कर की अधिकतम आयु जो अब भी गिनी जाए (डिफ़ॉल्ट 180, न्यूनतम 15, अधिकतम 1440 मिनट) |
रिस्पॉन्स फ़ील्ड — रिस्पॉन्स एनवेलप के data ऑब्जेक्ट के भीतर। [] सूची दर्शाता है, यानी data.items[].name हर एलिमेंट का name फ़ील्ड है। जिस फ़ील्ड का मान हमारे पास नहीं है वह null होता है, आता ही नहीं या खाली सूची होती है — प्लेसहोल्डर कभी नहीं।
| फ़ील्ड | विवरण |
|---|---|
data.condition.code | The marker, 0..5, with key the stable machine name (good, fog, snow, rain, ice, wind) and name the same thing in the requested language, worded for a driver ("Slippery!", not "freezing precipitation"). null when nothing was reported inside the window — see data.no_data. |
data.condition.severity | none | low | moderate | major, the same severity vocabulary road-conditions uses, with severity_name in the requested language. |
data.condition.severity_rank | Danger order when you sort several checkpoints: 1 ice, 2 fog, 3 snow, 4 rain, 5 wind, 6 clear. Lower is worse — the codes themselves are NOT an order. |
data.condition.hazard | true for anything but a clear road, so a client can gate an alert on one field. |
data.observed_at | When the marker was written (Europe/Kyiv), with observed_ts as a Unix timestamp. |
data.data_age_minutes | Age of that marker in minutes, with is_fresh true when it is under 3 hours old. Read it before treating the answer as current. |
data.source_type | community when a driver reported it, model when our weather model classified it. null when there is no marker. |
data.no_data | true when no marker exists for this checkpoint inside the window — an honest gap, not a clear road. Widen max_age_minutes or drop the sources filter. |
data.scale | The whole 0..5 vocabulary as an array indexed by code, so you can label a value without hardcoding our wording. |
data.sources | The filters actually applied, with window_minutes — both echoed back after clamping. |
curl "https://nakordoni.eu/api/v1/data/weather?ppid=id_13&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 इस एंडपॉइंट को सैंडबॉक्स में लाइव आज़माने के लिए डेवलपर के रूप में लॉग इन करें — प्रतिदिन 50 निःशुल्क टेस्ट कॉल। लॉग इन