API за гранична опашка на живо Online
Опашки в реално време, оценка на времето за изчакване и статус за всеки наблюдаван ГКПП. Включва блок snapshot: текуща опашка (queue_now), прогнозирано време wait_min, възраст на данните и източник.
GET https://nakordoni.eu/api/v1/data/queue
— клас квота: heavy
| Параметър | Описание |
|---|---|
ppid | Идентификатор на пункт, напр. id_13 (вижте /api/v1/data/checkpoints) |
section | Секция с данни (по избор) |
origin | Код на държава на произход (по избор) |
destination | Код на държава на местоназначение (по избор) |
Полета на отговора — вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
| Поле | Описание |
|---|---|
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"
🔑 Влезте като разработчик, за да изпробвате тази крайна точка на живо в sandbox — 50 безплатни тестови заявки на ден. Вход