Skip to main content
Menu

← Todos los endpoints

API Condiciones de la Carretera Online

Informes aprobados sobre el estado de la carretera cerca de las fronteras y en los corredores principales: baches, obras, cierres, hielo, peligros — combinando los informes de los conductores con las detecciones automáticas por acelerómetro de nuestra aplicación de navegación.

GET https://nakordoni.eu/api/v1/data/road-conditions — clase de cuota: cheap

ParámetroDescripción
countryCódigo de país ISO (opcional)
ppidCheckpoint ID, e.g. id_13 (optional). Scopes the answer to that crossing's corridor: the last 50 km of the main road to it on BOTH sides of the border
condition_typepothole|speed_bump|roadwork|closure|hazard|ice|… (opcional)
severitylow|moderate|major|critical (opcional)
latLatitud (opcional)
lngLongitud (opcional)
radiusRadio km (predeterminado 50)
sourcesall (default) | user (our own driver reports only) | external (road-authority and provider feeds only)
limitResultados máximos (predeterminado 100, tope 500)
offsetPagination offset (optional)
include_expired1 = also return conditions whose expiry has passed (optional)
langLanguage for condition_type_name / severity_name labels — all 24 site languages (default uk)

Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.

CampoDescripción
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[].sourceUpstream that reported it, with external_id — stable across refreshes, use it to deduplicate.
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"
🔑 Inicia sesión como desarrollador para probar este endpoint en vivo en el sandbox — 50 llamadas de prueba gratuitas al día. Iniciar sesión