API повітряних тривог і статистики

Публічне JSON API з поточними повітряними тривогами та статистикою по областях і районах України. Реєстрація і ключ не потрібні. Дані ті самі, що на сторінці статистики та карті.

Загальні правила

Базовий URL: https://xn--80adds5ajn.online/api/v1 (той самий API доступний і на https://tryvoha.online/api/v1).
Формат — JSON, кодування UTF-8. CORS відкритий (Access-Control-Allow-Origin: *), тож запити можна робити прямо з браузера.
Ліміт — 120 запитів за хвилину з IP. Відповіді кешуються на 30–60 секунд, тому опитувати частіше ніж раз на 30 секунд немає сенсу.
Усі часи — UTC у форматі ISO-8601. Тривалості — у хвилинах.
Параметр period приймає 24h, 7d або 30d; за замовчуванням 24h. Вікна рухомі — відлік від моменту запиту.
Регіон адресується через slug. Повний перелік слагів — у /api/v1/regions.

Методи

Метод	Що повертає
`GET /api/v1/regions`	Довідник регіонів: 24 області, м. Київ і всі райони. Для району `oblast_slug` вказує на його область.
`GET /api/v1/alerts`	Усі активні тривоги на цю мить — області та райони разом, з часом початку.
`GET /api/v1/alerts/{slug}`	Стан одного регіону. Для області додається список районів під тривогою та прапорець `active_anywhere`.
`GET /api/v1/stats?period=24h`	Зведення за період: загрози по типах і рейтинг областей за часом під тривогою.
`GET /api/v1/stats/{slug}?period=7d`	Статистика одного регіону: тривоги за період, останні епізоди, загрози по типах і розбивка по районах (для області).
`GET /api/v1/districts/{slug}?period=7d`	Тривоги по районах вказаної області за період.

Приклади

`GET /api/v1/alerts`

curl https://xn--80adds5ajn.online/api/v1/alerts

{
  "updated_at": "2026-08-31T08:47:35Z",
  "active": 43,
  "alerts": [
    {
      "slug": "brovarskii-raion",
      "type": "district",
      "name_uk": "Броварський район",
      "name_en": "Brovarskyi district",
      "oblast_slug": "kyivska",
      "started_at": "2026-08-31T08:21:06Z"
    }
  ]
}

`GET /api/v1/alerts/kyivska`

{
  "slug": "kyivska",
  "type": "state",
  "name_uk": "Київська область",
  "active": false,
  "started_at": null,
  "districts_active": [
    { "slug": "brovarskii-raion", "name_uk": "Броварський район", "started_at": "2026-08-31T08:21:06Z" }
  ],
  "active_anywhere": true
}

`GET /api/v1/stats/kyivska?period=24h`

{
  "slug": "kyivska",
  "type": "state",
  "period": "24h",
  "from": "2026-08-30T08:47:36Z",
  "to": "2026-08-31T08:47:36Z",
  "alerts": {
    "count": 5,
    "minutes_total": 746,
    "minutes_avg": 149,
    "minutes_max": 278,
    "recent": [
      { "started_at": "2026-08-31T08:20:51Z", "ended_at": null, "minutes": 27 },
      { "started_at": "2026-08-31T04:41:58Z", "ended_at": "2026-08-31T07:20:20Z", "minutes": 158 }
    ]
  },
  "threats": { "d": 35 },
  "districts": [
    {
      "slug": "brovarskii-raion",
      "name_uk": "Броварський район",
      "alerts": 7,
      "minutes_total": 1096,
      "minutes_avg": 157,
      "minutes_max": 457
    }
  ]
}

`GET /api/v1/districts/kyivska?period=7d`

{
  "oblast_slug": "kyivska",
  "period": "7d",
  "districts": [
    {
      "slug": "brovarskii-raion",
      "name_uk": "Броварський район",
      "name_en": "Brovarskyi district",
      "alerts": 42,
      "minutes_total": 4466,
      "minutes_avg": 106,
      "minutes_max": 506
    }
  ]
}

Як рахуються тривоги

Сирена оголошує тривогу переважно на рівні районів, тому «тривога в області» — це час, коли під тривогою був хоча б один її район. Інтервали районів, що перетинаються, об’єднуються в один епізод, тому count для області менший за суму тривог її районів.
Епізод, що ще триває, повертається з ended_at: null, а його тривалість рахується до моменту запиту.
Журнал тривог ведеться з 2 липня 2026 року, тож вікно 30 днів завжди повне.
Загрози (threats) — це розпізнані повідомлення про дрони, ракети й КАБи: d — ударні дрони, rd — розвідувальні дрони, m — ракети та КАБи, a — попередження про загрозу, u — інше.

Умови використання

API безкоштовне для некомерційного та комерційного використання за умови посилання на Тривога.online. Це інформаційний сервіс на основі відкритих джерел — він не є офіційним каналом оповіщення, і покладатися на нього в питаннях безпеки життя не можна. Гарантій доступності немає. Питання і запити на вищі ліміти — на пошту або в Telegram із футера.

Статистика тривог і загроз →

Тривога.online — інформаційний сервіс на основі відкритих джерел. Дані можуть оновлюватися із затримкою або містити неточності. Для критично важливих рішень користуйтеся офіційними джерелами сповіщень та дотримуйтеся вказівок органів влади.