API за указател на граничните пунктове Online
Указател на всички наблюдавани гранични пунктове: идентификатори, имена, държави, координати и статус. Използвайте го, за да откриете стойностите на ppid за останалите API.
GET https://nakordoni.eu/api/v1/data/checkpoints
— клас квота: cheap
| Параметър | Описание |
|---|---|
country | Филтриране по числов код на държава (1=UA, 2=PL, 3=SK, 4=HU, 5=RO, 6=MD, 7=BY, 8=LT, 9=LV, …) |
lang | Език за имената на пунктовете (по подразбиране en) |
Полета на отговора — вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
| Поле | Описание |
|---|---|
data.checkpoints[].ppid | Checkpoint ID — the value every other product's ppid parameter takes. |
data.checkpoints[].name | Checkpoint name in the requested language. |
data.checkpoints[].origin | Numeric country code of the side the crossing is operated from. |
data.checkpoints[].destination | Numeric country code of the country across the border. |
data.checkpoints[].crossing_type | Vehicle type this row is monitored for: 4=car, 5=taxfree car, 6=bus, 7=pedestrian, 8=truck (Freight Transport), 9=truck up to 7.5 t. |
data.checkpoints[].timezone | IANA timezone of the crossing — every timestamp for it is in this zone. |
data.checkpoints[].status | 1=open, 3=closed, 0=inactive. |
data.checkpoints[].redirect_to | Present only on a checkpoint that was RETIRED as a duplicate of another one at the same physical crossing: the ppid that superseded it. Such a row always carries status 0 — point your integration at the id named here. The retired id still answers the other products for now, but it is not the canonical one and is not guaranteed to keep updating. |
data.checkpoints[].has_day_stats | false means the Best Time to Cross product has no matrix for this checkpoint and would answer 404 — skip it rather than poll it. |
data.checkpoints[].has_live_data | Whether a live queue value currently exists for this checkpoint, i.e. whether the queue and border products will return a number for it rather than nothing. It says nothing about how recent that number is — read last_observation for that. About 65 of the monitored checkpoints have no live source at all. Absent from every row if the live-value store could not be read at all, so treat "key missing" as unknown, not as false. |
data.checkpoints[].last_observation | ISO 8601 timestamp of the live value behind has_live_data, or null when there is none. Some checkpoints keep answering with a value that stopped moving long ago — a few of them years ago — so check this age before presenting the queue as current. |
data.checkpoints[].data_quality | How the current live value was arrived at: high = counted from a real observation source at the crossing, low = a modelled estimate where no counting source exists. Same vocabulary as the Best Time to Cross and live queue products. Present only when has_live_data is true; omitted otherwise. Both are real answers — low is not an error — but a low value is an estimate and should be labelled as one if you show it to drivers. |
data.count | Number of checkpoints returned. |
curl "https://nakordoni.eu/api/v1/data/checkpoints" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Влезте като разработчик, за да изпробвате тази крайна точка на живо в sandbox — 50 безплатни тестови заявки на ден. Вход