Инструменты пользователя

Инструменты сайта


Боковая панель

Разделы

Общее описание
История изменений
Рекомендации к обновлению
Планы на будущее
Известные проблемы
Онлайн демо
Случайная статья
Видео
Помощь проекту
Люди

FAQ



Редактировать сайдбар

aerialalertsapi

API Повітряних тривог

От таке от актуальне на даний час API, повітряних тривог на території України. Аби довго не гратись та не розбирати потім купу складних структур даних, було прийнято рішення проксювати існуючі розрізнені джерела даних, що в основному парсять Telegram канал @air_alert_ua і звести їх до якогось одного уніфікованого та компактного формату. Також в такій важливій справі, хочеться трішки редандансі й мінімізувати навантаження на оригінальні джерела даних.

Тому ось, маєте, можете користуватись:

https://ubilling.net.ua/aerialalerts/

ну або напряму без SSL:

http://ubilling.net.ua/aerialalerts/

Наразі таймаут кешування сирих даних з боку нашої імплементації - 3 секунди.

Формат відповідей у вигляді JSON простий, наскільки це можливо:

У випадку, якщо ви знаходитесь під дією важких наркотиків, вам може захотілись, отримувати дані в форматі XML. Чомусь… Робиться це за допомогою передачі додаткового GET параметру xml, власне так:

https://ubilling.net.ua/aerialalerts/?xml=true

Як користуватись?

Наочний приклад, як це можна використовувати на практиці:

    $aerialAlertsApi = new OmaeUrl('http://ubilling.net.ua/aerialalerts/');
    $rawJson = $aerialAlertsApi->response();
    $alertsData = json_decode($rawJson, true);
    if (isset($alertsData['states'])) {
        foreach ($alertsData['states'] as $eachStateName => $stateParams) {
            if ($stateParams['alertnow']) {
                show_error($eachStateName);
            } else {
                show_success($eachStateName);
            }
        }
    }

Джерела даних

Також ви можете явно вказати джерело, з якого бажаєте отримати дані, за допомогою GET параметру source власне якось так:

https://ubilling.net.ua/aerialalerts/?source=[джерело_даних]

Наразі підтримуються наступні джерела даних:

  • dunai - від Andrew Dunai
  • klimenko - від Vadym Klymenko

У випадку, якщо джерело явно не вказано - буде обрано найбільш живе ;)

У будь-якому випадку, не варто сприймати це API як стовідсотково надійне та надто на нього покладатись, використовуючи його для прийняття якихось важливих рішень. Чисто інформаційно-статистична штука загалом. Користуйтесь офіційними джерелами інформації!

Тривожна мапа

А ще ви можете отримати +- актуальну тривожну мапу локацій де нам намагаються принести «русскій мір» за допомогою якогось отакого запиту

https://ubilling.net.ua/aerialalerts/?map=true

Посилання

aerialalertsapi.txt · Последние изменения: 2022/05/24 13:56 — nightfly