Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- aerialalertsapi [2025/11/11 12:17] – [Джерела даних] nightfly
+++ aerialalertsapi [2026/09/07 15:30] (поточний) – nightfly
@@ Рядок 1: / Рядок 1: @@
 ====== API Повітряних тривог ======
-От таке от актуальне на даний час REST API, повітряних тривог на території України. Аби довго не гратись та не розбирати потім купу складних структур даних, було прийнято рішення проксювати існуючі розрізнені джерела даних і звести їх до якогось одного уніфікованого та компактного формату. Також в такій важливій справі, хочеться трішки редандансі й мінімізувати навантаження на оригінальні джерела даних, аби пересічні розробники мали можливість просто та елегантно нотифікувати користувачів, про те, що їм намагаються принести "русскій мір".
+REST API, повітряних тривог на території України. Без ключів, без авторизації, без аутентифікації, без реєстрації, без SMS та здачі аналізів. Аби довго не гратись та не розбирати потім купу складних структур даних, було прийнято рішення проксювати існуючі розрізнені джерела даних і звести їх до якогось одного уніфікованого та компактного формату. Також в такій важливій справі, хочеться трішки редандансі й мінімізувати навантаження на оригінальні джерела даних, аби пересічні розробники мали можливість просто та елегантно нотифікувати користувачів, про те, що їм намагаються принести "русскій мір".
 Тому ось, маєте, можете користуватись:
@@ Рядок 14: / Рядок 14: @@
 Наразі таймаут кешування сирих даних з боку нашої імплементації - **3 секунди**.\\
-На жаль, враховуючи неадекватність окремих мавпочок, які не можуть як в програмування так і в здоровий глузд, швидкість звернень до API було лімітовано на межі 2 rps (два запити на секунду) для кожного хоста, з 2024-02-13. У випадку перевищення цього ліміту (а, що курва мало б змінитись частіше ніж двічі на секунду?!) ви отримаєте http error 429.
+На жаль, враховуючи неадекватність окремих мавпочок, які не можуть як в програмування так і в здоровий глузд, швидкість звернень до API було лімітовано на межі 2 rps (два запити на секунду) для кожного хоста, з 2024-02-13. У випадку перевищення цього ліміту (а, що курва мало б змінитись частіше ніж двічі на секунду?!) ви отримаєте http error 429. І можливо пермабан. За настроєм.
 Формат відповідей у вигляді JSON простий, наскільки це можливо:
@@ Рядок 20: / Рядок 20: @@
 {{:undefined:aerialalertsapi0_2.png|}}
-У випадку, якщо ви знаходитесь під дією важких наркотиків, вам може захотітись, отримувати дані в форматі XML. Чомусь... Робиться це за допомогою передачі додаткового GET параметру **xml**, власне так:
+У випадку, якщо ви знаходитесь під дією важких наркотиків, вам може захотітись, отримувати дані в форматі XML. Чомусь... Робиться це за допомогою передачі API, додаткового GET параметру **xml**, власне так:
 <code>
@@ Рядок 69: / Рядок 69: @@
 {{:alertold.png?32 |}}
-**УВАГА!** У будь-якому випадку, не варто сприймати це API як стовідсотково надійне та надто на нього покладатись, використовуючи його для прийняття якихось важливих рішень. Чисто інформаційно-статистична штука загалом. Користуйтесь офіційними джерелами інформації!
+**УВАГА!** У будь-якому випадку, не варто сприймати це АПІ як стовідсотково надійне та надто на нього покладатись, використовуючи його для прийняття якихось важливих рішень. Чисто інформаційно-статистична штука загалом. Користуйтесь офіційними джерелами інформації!
+====== Сирі дані ======
+Також є можливість отримати сирі необроблені дані у форматі будь-якого джерела, передавши (можна порожній) GET параметр **raw** наприклад якось так:
+<code>
+https://ubilling.net.ua/aerialalerts/?source=skog&raw
+</code>
+чи якось так:
+<code>
+https://ubilling.net.ua/aerialalerts/?source=klimenko&raw
+</code>
+та отримати якийсь такий результат:
+{{:arialskograw.png|}}
+Варто зауважити, що дані буде повернуто в ключі **raw** замість **states** і вони будуть саме що сирими, та необробленими і не зведеними до якогось одного, уніфікованого формату. За для розуміння структури цих даних звертайтесь до документації відповідного джерела даних. Там же можете пошукати собі дані по районах, чи територіальних громадах.
 ====== Тривожна мапа ======
@@ Рядок 101: / Рядок 121: @@
 https://ubilling.net.ua/aerialalerts/?map=webp
 </code>
+====== Веб-тривожність ======
+Також ви можете отримати веб-версію тривожності за допомогою необов'язкового (можна порожнього) GET параметру **webalerts**, якось так:
+<code>
+https://ubilling.net.ua/aerialalerts/?webalerts
+</code>
+що виглядатиме приблизно так
+{{:aerialskogenwebalerts.png|}}
 ====== Посилання ======
@@ Рядок 107: / Рядок 140: @@
   * [[https://vadimklimenko.com/map/|єМапа by Vadim Klimenko]]
   * [[https://github.com/and3rson/raid|Air Raid Alerts API by Andrew Dunai]]
+  * [[https://github.com/nightflyza/skogen|Mork Skogen API]]
   * [[https://jaam.net.ua/|Сервер даних JAAM]]
   * [[https://alerts.in.ua/|alerts.in.ua]]