REST API¶
JSON-ендпоінти й картинки мапи. Авторизація не потрібна.
REST
https://jaam.net.uaWebSocket
wss://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 | Готові картинки мапи |
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.