API Coda di Frontiera in Tempo Reale Online
Code in tempo reale, stima del tempo di attesa e stato per qualsiasi valico monitorato. Include un blocco snapshot: coda attuale (queue_now), tempo di attesa stimato wait_min, anzianità dei dati e fonte.
GET https://nakordoni.eu/api/v1/data/queue
— classe di quota: heavy
| Parametro | Descrizione |
|---|---|
ppid | ID del valico, ad es. id_13 (vedi /api/v1/data/checkpoints) |
section | Sezione dati (opzionale) |
origin | Codice paese di origine (opzionale) |
destination | Codice paese di destinazione (opzionale) |
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[] | Hourly series for the checkpoint, oldest first — one element per reading. |
data[].time | Unix timestamp of the reading, in the checkpoint's own timezone. |
data[].avg_cars | Vehicles in the queue at that hour. |
data[].wait_time | Wait in minutes at that hour. |
data[].wait_time_estimated | true = the wait is our estimate from the queue length, not an official figure. |
data[].type_of_data | 1 = a real observation; 2 = a forecast point (future hours). It says whether the row was measured or predicted — it carries no information about where the reading came from. |
data[].data_quality | How that row was arrived at: high = counted from a real observation source at the crossing, low = a modelled estimate where no counting source exists. Present on observation rows only (type_of_data 1) — a forecast point is predicted by definition. 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 it is an estimate and should be labelled as one if you show it to drivers. |
snapshot.timezone | IANA zone that snapshot.updated_at is expressed in — it is the checkpoint's own local time, not one fixed zone (e.g. Europe/Istanbul for id_385, Europe/Sofia for id_390, Europe/Budapest for id_407). Use it to resolve updated_at to an absolute instant. |
snapshot | Envelope-level, beside data: the current state — queue_now, wait_min, updated_at, timezone, age_min, data_quality. Read this for 'now'; data is the history behind it. |
curl "https://nakordoni.eu/api/v1/data/queue?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