Skip to main content
Menu

← Tutti gli endpoint

Air Alert Proximity API Online

Air-raid alerts and airborne objects near ONE border crossing. Anchor on a checkpoint (ppid), a coordinate pair or a city and get back only what is inside your radius (default 100 km): which regions are under alert, how far each is, and how close any tracked object currently is on a 1-5 proximity band. Regions are returned as ISO 3166-2 region_code, the same classifier the regional fuel data uses. DELIBERATELY NOT REAL-TIME: every response is a snapshot 1-3 minutes old with the lag re-randomised per request and stated in as_of/lag_min, and object coordinates are never returned - only distance, bearing and speed relative to your anchor. Source data is crowd/OSINT-derived and partly hand-moderated: a signal, never ground truth, and never a substitute for official air-raid warnings.

GET https://nakordoni.eu/api/v2/data/air-alerts — classe di quota: cheap

ParametroDescrizione
ppidCheckpoint ID to anchor on, e.g. id_94 — use the Checkpoints Directory API to discover it. Alternative to lat/lon.
latLatitude of the anchor point (alternative to ppid)
lonLongitude of the anchor point (alternative to ppid)
cityCity name — alternative to lat/lon, resolved to coordinates
countryISO-2 country code, disambiguates city
radius_kmSearch radius in km around the anchor (default 100, min 10, max 300). The 1-5 proximity band is scaled to this radius: 5 = nearest fifth, 1 = outermost fifth.
langLanguage code (default en)

Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.

CampoDescrizione
data.anchorWhat the radius was measured from: ppid, lat, lng, radius_km.
data.as_ofSnapshot time — DELIBERATELY not real-time. lag_min states the delay, re-randomised per request, and lag_note explains it.
data.alerts.countRegions under alert inside the radius, with region_codes (ISO 3166-2) and items — each with its distance from the anchor.
data.alerts.unresolvedAlerts that could not be placed on a region, with merged — how many overlapping ones were combined.
data.targets.countTracked objects inside the radius, with items — distance, bearing, speed and a 1-5 proximity band ONLY. Coordinates are never returned.
data.targets.by_typeCounts per object type, with tracked_total across the whole feed.
data.attributionSource labels you must display, with a note per source.
data.labelsLocalised UI strings, including the disclaimer — crowd/OSINT data, never a substitute for official air-raid warnings.
curl "https://nakordoni.eu/api/v2/data/air-alerts?ppid=id_94&radius_km=100" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 50 chiamate di prova gratuite al giorno. Accedi