Подача новин і флот NakBus тепер у партнерській панелі
Підключіть свій обліковий запис розробника до акаунту Nakordoni Partners з тією самою електронною поштою і керуйте новинами та своїм автобусним флотом (NakDriver / NakManager) там, із ролями команди. Ваші API-ключі, ендпоінти й застосунки залишаються без змін, а сторінки тут продовжують працювати. Відкрити Nakordoni Partners
API кількох пунктів пропуску Online
Отримуйте статус черги та актуальність даних для до 5 пунктів пропуску в одному запиті. Квота рахується як ⌈(N PPID × під-продукти) / 2⌉ — на 50% дешевше, ніж еквівалентні окремі виклики. Використовуйте include=queue,update-info для отримання обох наборів даних одразу. З 2026-08-30 запит із більш ніж 5 PPID обробляється лише для перших 5: решта ігноруються (повертаються в meta.ppid_cap.ignored) і не списуються з квоти.
GET https://nakordoni.eu/api/v1/data/multi
— клас квоти: heavy
| Параметр | Опис |
|---|---|
ppids | Comma-separated list of checkpoint IDs (required, max 5 from 2026-08-30) — e.g. id_2,id_13,id_15. Extra IDs beyond the fifth are ignored, not rejected. |
include | Comma-separated sub-products to include: queue, update-info (default: queue,update-info) |
lang | Language code for checkpoint names in queue responses (default: en) |
Поля відповіді — усередині об’єкта data у конверті відповіді. [] позначає список, тож data.items[].name — це поле name кожного елемента. Поле буває null, відсутнє або порожній список, коли значення в нас немає, — заглушок ми не підставляємо.
| Поле | Опис |
|---|---|
data.<ppid> | One object per requested checkpoint, keyed by ppid — not an array. A ppid you asked for that we do not monitor is absent. |
data.<ppid>.queue | Present when include contains queue: found, queue_now, wait_min, wait_status, trend_percent, trend_direction, age_min, freshness, name, updated_at, data_quality. |
data.<ppid>.update_info | Present when include contains update-info: found, timestamp, datetime, timezone, age_seconds, age_minutes, freshness, queue_now, data_quality. |
data.<ppid>.*.data_quality | On both sub-products: high = counted from a real observation source at the crossing, low = a modelled estimate where no counting source exists. Same high|low vocabulary as the checkpoints directory, Border Queue and Best Time to Cross. Both are real answers; a low value is an estimate and should be labelled as one if you show it to drivers. |
meta.ppids_requested | How many ppids the call asked for (envelope level, beside data). |
meta.units_consumed | Quota units this call actually cost — ⌈(ppids × sub-products) / 2⌉, counted on the checkpoints actually answered. |
meta.ppid_cap | Present ONLY when the call listed more than 5 PPIDs: cap, enforced_from, enforced, ppids_asked, ppids_answered, ignored[] and a plain-language notice. The same event also sets the X-Devapi-Warning response header. |
curl "https://nakordoni.eu/api/v1/data/multi?ppids=id_2,id_13,id_15&include=queue,update-info&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Увійдіть як розробник, щоб протестувати цей ендпоінт наживо в пісочниці — 50 безкоштовних тестових викликів на день. Увійти
Оновлено