Подача новин і флот NakBus тепер у партнерській панелі
Підключіть свій обліковий запис розробника до акаунту Nakordoni Partners з тією самою електронною поштою і керуйте новинами та своїм автобусним флотом (NakDriver / NakManager) там, із ролями команди. Ваші API-ключі, ендпоінти й застосунки залишаються без змін, а сторінки тут продовжують працювати. Відкрити Nakordoni Partners

← Усі ендпоінти

API стану доріг Online

Підтверджені звіти про стан доріг поблизу кордонів та на основних коридорах: вибоїни, дорожні роботи, перекриття, ожеледь, небезпеки — поєднання звітів водіїв з автоматичним виявленням акселерометром із нашого навігаційного застосунку.

GET https://nakordoni.eu/api/v1/data/road-conditions — клас квоти: cheap

ПараметрОпис
countryISO-код країни (необов'язково)
ppidID пункту пропуску, напр. id_13 (необов'язково). Обмежує відповідь коридором цього переходу: останні 50 км головної дороги до нього з ОБОХ боків кордону
condition_typepothole|speed_bump|roadwork|closure|hazard|ice|… (необов'язково)
severitylow|moderate|major|critical (необов'язково)
latШирота (необов'язково)
lngДовгота (необов'язково)
radiusРадіус, км (за замовчуванням 50)
sourcesall (типово) | user (лише повідомлення наших водіїв) | external (лише фіди дорожніх служб і провайдерів)
limitМакс. результатів (за замовчуванням 100, ліміт 500)
offsetЗсув пагінації (необов'язково)
include_expired1 = також повертати умови, термін дії яких минув (необов'язково)
langМова для підписів condition_type_name / severity_name — усі 24 мови сайту (типово uk)

Поля відповіді — усередині об’єкта data у конверті відповіді. [] позначає список, тож data.items[].name — це поле name кожного елемента. Поле буває null, відсутнє або порожній список, коли значення в нас немає, — заглушок ми не підставляємо.

ПолеОпис
data.conditions[].condition_typeWhat it is (roadworks, closure, accident, weather…), with condition_type_name in the requested language.
data.conditions[].severityHow bad it is, with severity_name.
data.conditions[].descriptionFree-text detail as published, with road_name and direction.
data.conditions[].latitudeWhere it is, with longitude and country_code.
data.conditions[].corridor_ppidThe border crossing whose approach corridor this sits on, when it is on one.
data.conditions[].estimated_durationHow long it is expected to last, with expires_at and created_at.
data.conditions[].external_idOpaque stable id of a feed incident ("rc_" + 16 hex, null for our own driver reports) — the same incident keeps it across polls, use it to deduplicate. id is a stable int.
data.totalMatches for the query, with limit and offset for paging.
curl "https://nakordoni.eu/api/v1/data/road-conditions?ppid=id_13&lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Увійдіть як розробник, щоб протестувати цей ендпоінт наживо в пісочниці — 50 безкоштовних тестових викликів на день. Увійти

Оновлено