API для разработчиков

Простые JSON-эндпоинты. Без ключа для базового использования.

Все эндпоинты отдают JSON с разрешением CORS (Access-Control-Allow-Origin: *) — можно обращаться прямо из браузера. Базовое использование бесплатно при условии ссылки на источник (map.megainet.art).

Эндпоинты

Эндпоинт	Что возвращает
`GET /api/alerts.php`	Состояние тревог по областям + районные тревоги
`GET /api/threats.php`	Активные угрозы (дроны, ракеты, КАБы) с координатами и курсом
`GET /api/feed.php`	Лента сообщений мониторов + носители (МиГ-31К и т.д.)
`GET /api/stats.php`	Статистика за сутки по типам + почасовая гистограмма
`GET /api/fires.php`	Термоточки NASA FIRMS за 24 ч (bbox Украины)
`GET /api/occupied.php`	Линия фронта и серая зона (GeoJSON)

Пример

curl -s https://map.megainet.art/api/alerts.php

Ответ (сокращённо)

{
  "source": "siren/districts",
  "updated": "2026-07-23 20:15:02",
  "regions": {
    "UA-63": { "alert": true,  "changed_ts": 1784500000 },
    "UA-12": { "alert": false, "partial": [ { "name": "Нікопольський район", "ts": 1784499000 } ] }
  },
  "local": [ { "name": "Нікопольський район", "oblast": "Дніпропетровська область", "lat": 47.57, "lon": 34.4 } ]
}

Лимиты и тарифы

Базовый бесплатный лимит — около 60 запросов в минуту с IP. Нужно больше или без ссылки-кредита? Смотрите тарифы.

Авторизация и ключи

Базовые эндпоинты работают без ключа — тогда лимит считается по IP. Бесплатный ключ уровня Free (120 запросов/мин) выдаётся в один клик на странице ключа, без регистрации. Передавайте его параметром ?key=ak_… или заголовком X-API-Key. В каждом ответе есть заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Tier; при превышении лимита возвращается 429 с Retry-After.

Справочный сервис. Не заменяет официальные сигналы тревоги — идите в укрытие по сирене.

Разработано в OSTOHLO