Зміни надзвичайних ситуацій

Підключення

Передайте API-ключ у заголовку Authorization. Відповідь має тип text/event-stream. Відкриття з’єднання враховується в квоті HTTP-запитів; окремі події її не витрачають. Фільтри URL не підтримуються. Звичайний EventSource не дозволяє задавати Authorization: використовуйте fetch або SSE-клієнт із підтримкою заголовків. Не передавайте ключ у URL і не публікуйте його у відкритому клієнтському коді.

Початок підписки

При підключенні сервер не надсилає початковий список, system або попередні події. Надходять лише нові зміни після встановлення підписки та heartbeat. За потреби окремо отримайте початкові дані через HTTP API.

Формат кадру

Поле event задає ім’я події, data містить JSON. Порожній рядок завершує кадр. Об’єкт передається без обгортки data. id є номером кадру в межах з’єднання, а не ідентифікатором запису чи курсором історії.

emergency

При оголошенні та зміні рівня передаються katottg, type, level і start. При завершенні передаються katottg, type та end. Зміна рівня не створює нової ситуації: оновіть поточну. Повні списки emergencies у цьому потоці не надсилаються.

katottgstring

Код території, якої стосується зміна.

typestring

Тип надзвичайної ситуації, наприклад air.

levelinteger · optional

Поточний рівень при оголошенні або зміні рівня. Для AIR: 1 жовтий, 2 червоний, 3 підвищений. При завершенні відсутній.

startstring · date-time · optional

Час початку ситуації в ISO 8601 UTC. Передається при оголошенні та зміні рівня; при зміні рівня зберігає початковий час ситуації.

endstring · date-time · optional

Час завершення в ISO 8601 UTC. Передається лише при завершенні; level і start у такому кадрі відсутні.

heartbeat

Надходить кожні 10 секунд, навіть якщо нових змін немає. Підтверджує роботу з’єднання.

tsinteger

Серверний Unix timestamp у мілісекундах.

Відновлення з’єднання

Fetch самостійно не перепідключається: після обриву відкрийте нову підписку з паузою між спробами. При 429 враховуйте Retry-After, при 401 перевірте API-ключ. Сервер не відтворює пропущені зміни через Last-Event-ID. Для синхронізації перечитайте дані через HTTP API. При завершенні роботи закривайте з’єднання.