Перейти до змісту

REST API

2 хв читання Оновлено 21 листопада 2026 API JAAM

JSON-ендпоінти й картинки мапи. Авторизація не потрібна.

RESThttps://jaam.net.ua
WebSocketwss://ws.jaam.net.ua/data_service_v1

Усі відповіді — JSON у UTF-8, крім .png і .plain. Повний опис полів є в Swagger.

Ендпоінти

ЕндпоінтЩо повертає
GET/alerts_statuses_v1.jsonТривоги по областях: enabled, district, enabled_at
GET/alerts_statuses_v2.jsonТривоги по областях: alertnow, district, changes
GET/alerts_statuses_v3.jsonНайкомпактніший: {"states": {"<область>": true/false}}
GET/weather_statuses_v1.jsonПогода по областях: температура, опис, тиск, вологість, вітер
GET/weather_statuses_v2.jsonРозширені погодні дані, ключ — id регіону
GET/tcp_statuses_v1.jsonТривоги й погода одним рядком у JSON
GET/tcp_statuses_v2.plainТе саме, звичайним текстом
GET/api_status.jsonСкільки секунд тому оновилися джерела: тривоги, погода, енергосистема, радіація
GET/alerts_map.png, /weather_map.pngГотові картинки мапи
bash
curl -s https://jaam.net.ua/alerts_statuses_v3.json
Застарілі ендпоінти повертають 410 Gone

explosives_statuses_*.json, missiles_statuses_*.json, drones_statuses_*.json, kabs_statuses_*.json. Не використовуйте їх і не опитуйте повторно.

Вимоги до REST-клієнта

30 сЧастотаНе частіше ніж раз на 30 секунд для одного ендпоінта. Дані оновлюються не миттєво.
1Одна версіяНе опитуйте кілька версій одного ендпоінта. Оберіть одну.
5xxПомилкиПовторюйте з наростаючою затримкою, а не в циклі без паузи.
UAUser-AgentВказуйте осмислений, щоб вас відрізняли від ботів.
Потрібні оновлення в реальному часі?

Використовуйте WebSocket API замість частого опитування REST.