stable · overview · 0.1.0

Realtime

Ephemeral transport

Realtime gateway 是低延遲、best-effort transport。Project Backend 擁有 channel membership、訊息歷史、未讀狀態、封鎖、moderation 與 reconnect replay；重要狀態必須能從 authoritative API 重新查詢，不能只存在 Realtime。

Project Backend 以 Project Credential 取得五分鐘 short-lived grant，只授權指定 subject、channels 與 subscribe／publish capabilities。Client 使用 grant 連到 realtime.minicenter.otus.tw 的 WebSocket 或 SSE endpoint；publish 則使用 HTTPS。

Realtime Message 不是 Domain Event，因此沒有 Event schema 或 durable replay。需要 canonical payload、at-least-once delivery 或 replay 時，使用 Events & Webhooks。

從連線、publish 與 subscribe開始，再閱讀security、expiry、reconnect 與 backpressure。

Guides

• Manage Project Client Browser Origins — Register exact environment-scoped origins used by browser Realtime CORS.
• 連線、publish 與 subscribe — 核發 channel grant，使用 SSE 或 WebSocket subscribe，並 publish ephemeral message。
• Security、expiry、reconnect 與 backpressure — 安全限制 Realtime grant、處理 connection quota、expiry、斷線與 best-effort delivery。

API Reference

• Issue a short-lived Realtime grant — POST /api/v1/realtime-grants