Trimiterea știrilor și flota NakBus se află acum în panoul de partener
Conectați-vă contul de dezvoltator la un cont Nakordoni Partners cu același e-mail și gestionați acolo știrile și flota dvs. de autobuze (NakDriver / NakManager), cu roluri de echipă. Cheile API, punctele finale și aplicațiile dvs. rămân neschimbate, iar paginile de aici continuă să funcționeze. Deschide Nakordoni Partners
API pentru condițiile meteo la frontieră Online
Pericolul rutier la un punct de trecere pe o singură scară 0–5: drum curat, ceață, zăpadă, ploaie, polei sau vânt puternic — denumit în limba dvs., clasificat după gravitate, cu vechimea valorii și sursa: șofer sau modelul nostru.
GET https://nakordoni.eu/api/v1/data/weather
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
ppid | ID punct de control, de exemplu id_13 (vezi /api/v1/data/checkpoints) |
lang | Limba denumirilor condiției și gravității (25 de limbi; implicit en) |
sources | all (implicit) | community — doar raportările șoferilor | model — doar clasificarea noastră |
max_age_minutes | Vechimea maximă a unei valori încă luate în calcul (implicit 180, min. 15, max. 1440 de minute) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
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"
🔑 Autentifică-te ca dezvoltator pentru a testa acest endpoint live în sandbox — 50 de apeluri de test gratuite pe zi. Autentificare
Actualizat