Skip to main content
app.realtime() apre uno stream Server-Sent Events e restituisce la Response grezza. L’SDK non analizza i frame SSE al posto tuo — ti consegna lo stream così puoi collegarlo al tuo event loop.

Limiti di connessione

  • Ogni connessione dura fino a 10 minuti (il suo TTL). Il server esegue una riconnessione interna trasparente al raggiungimento del TTL, ma il client deve comunque riconnettersi al termine dello stream.
  • Un singolo account può mantenere al massimo 5 connessioni simultanee aperte, con un limite aggiuntivo per applicazione. Il superamento di uno dei due limiti fallisce con code: "REALTIME_MAX_CONNECTIONS".
  • app.realtime() restituisce la Response grezza; il suo body è lo stream SSE.

Struttura degli eventi

Lo stream emette due tipi di frame:
  • event: system — messaggi di ciclo di vita della connessione come REALTIME_CONNECTING, REALTIME_TIMEOUT, ecc.
  • event: message — il payload JSON dell’applicazione

Consumare lo stream

Ogni chiamata a app.realtime() restituisce una nuova Response. Per restare connesso oltre il timeout di 10 minuti del server, riconnettiti quando lo stream termina.