Anlık akış (SSE)

GET https://api.<alan>/v1/olaylar sunucu gönderimli olaylar (Server-Sent Events) akışıdır. Bağlantı açık kalır, servis edilen her içerik birkaç saniye içinde gelir. Kapsam akis.oku, paket kanalı anlik_akis.

bash

curl -N "https://api.<alan>/v1/olaylar" -H "Accept: text/event-stream" -H "Authorization: Bearer $YHA_ANAHTAR"

metin

id: MjAyNi0xMC0wN1QxMToxOTowMC4xMjNafDhm…
event: yeni
data: {"olay_id":"…","imlec":"…","olay":"yeni","zaman":"…","icerik":"haber","haber":{…},"varlik":null}

: canli

event olayın türüdür (yeni, duzeltme, iptal, guncelleme); data bir DisOlay'dır (akıştakiyle aynı).
Her 25 saniyede : canli yorumu gelir; bağlantıyı açık tutun.
Kaldığı yerden sürme: yeniden bağlanırken Last-Event-ID: <son id> (ya da ?imlec=) gönderin. Kopukluk son 24 saat ve 1000 olay içindeyse kaçırılanlar sırayla gelir. Daha uzunsa event: yeniden_yukle gelir ve bağlantı kapanır: /v1/akis?imlec= ile tamamlayıp yeniden bağlanın.
Abonelik askıya alınır ya da anahtar iptal edilirse event: kapandi ({"neden":"…"}) gelir.
Accept: text/event-stream yoksa 406 kabul_edilemez. Anahtar başına aynı anda en çok 3 bağlantı (429 es_zamanli_baglanti_siniri).
Bağlantının açılması bir çağrı sayılır; olaylar sayılmaz.
Önceden verilen embargolu içerik embargo bilgisiyle hemen gelir; saatinden önce yayımlamayın.
Süzgeçler akıştakilerle aynıdır: icerik, kategori_id, il_id, oncelik, olay, paket_id.
Aynı olay iki kez gelebilir: olay_id ile ayıklayın.