Нові повідомлення

Підключення

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

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

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

Формат кадру

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

event

Надходить після створення опублікованого повідомлення або переведення чернетки у стан опублікованого. Неопубліковані записи не передаються. Звичайне редагування, видалення та зняття з публікації не створюють event у цьому потоці.

titlestring: Заголовок повідомлення.
textstring: Текст повідомлення.
typestring: Тип повідомлення з довідника /api/v1/event/types.
datestring · date-time: Дата й час події у форматі ISO 8601 UTC, наприклад 2026-09-23T07:00:00.000Z.
katottgsarray<string>: Коди територій, яких стосується повідомлення, або global для загального повідомлення.

heartbeat

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

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

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

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