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"
🔑 Најавете се како развивач за да ја пробате оваа крајна точка во живо во песочникот — 50 бесплатни тест повици дневно. Најава