API di coda in tempo reale e freschezza Online
Quando un valico è stato aggiornato l'ultima volta, da quale fonte, e una valutazione della freschezza.
GET https://nakordoni.eu/api/v1/data/update-info
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
ppid | ID del punto di controllo, ad es. id_13 (vedi /api/v1/data/checkpoints) |
lang | Codice lingua |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
data.queue_now | Vehicles in the queue at the latest reading. |
data.timestamp | When that reading was taken (unix), with datetime and timezone — the checkpoint's own zone. |
data.age_seconds | How old the reading is now, also as age_minutes and age_hours. |
data.freshness | Plain-language band for that age. is_realtime says the row is an observation rather than a forecast point — it does NOT say the observation was counted; read data_quality for that. |
data.data_quality | high = the reading was counted from a real observation source at the crossing; low = a modelled estimate, because that checkpoint has no counting source. Same high|low vocabulary as the checkpoints directory, Border Queue and Best Time to Cross. Both are real answers; low is not an error, but do not present a low value to drivers as a measurement. |
data.found | false = we monitor the checkpoint but hold no reading; status carries the reason. |
data.origin | Which upstream the reading came from. |
curl "https://nakordoni.eu/api/v1/data/update-info?ppid=id_13" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 50 chiamate di prova gratuite al giorno. Accedi