API für Wetterbedingungen an der Grenze Offline
Die Straßengefahr an einem Grenzübergang auf einer einzigen Skala 0–5: freie Straße, Nebel, Schnee, Regen, Glatteis oder starker Wind — benannt in Ihrer Sprache, nach Schweregrad eingestuft, mit dem Alter des Werts und der Quelle: Fahrer oder unser Modell.
GET https://nakordoni.eu/api/v1/data/weather
— Kontingentklasse: cheap
| Parameter | Beschreibung |
|---|---|
ppid | Checkpoint-ID, z. B. id_13 (siehe /api/v1/data/checkpoints) |
lang | Sprache für Zustands- und Schweregradnamen (25 Sprachen; Standard en) |
sources | all (Standard) | community — nur Fahrermeldungen | model — nur unsere eigene Einstufung |
max_age_minutes | Höchstalter eines Werts, der noch zählt (Standard 180, min. 15, max. 1440 Minuten) |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
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"
🔑 Melden Sie sich als Entwickler an, um diesen Endpunkt live in der Sandbox auszuprobieren — 50 kostenlose Testaufrufe pro Tag. Anmelden