Modifiche alla banca dati
Iscriviti a inserimenti, aggiornamenti ed eliminazioni su una tabella non appena si verificano.
In tempo reale
Una connessione WebSocket trasporta modifiche al database, messaggi broadcast e presenza. I canali privati seguono la stessa sicurezza a livello di riga delle tue tabelle.
import { createClient } from '@aurabase/aurabase-js'const aura = createClient('https://my-project.aurabase.cloud','aura_anon_xxx',)aura.channel('room').on('postgres_changes',{event: 'INSERT',schema: 'public',table: 'messages',filter: 'room_id=eq.42',},(payload) => console.log(payload),).subscribe()
Cosa è incluso
Iscriviti a inserimenti, aggiornamenti ed eliminazioni su una tabella non appena si verificano.
Ricevi solo le righe che ti interessano, ad esempio room_id=eq.42. Il server applica il filtro prima di inviare l'evento.
Invia messaggi tra client su un canale, con riconoscimento del server opzionale.
Tieni traccia degli utenti su un canale e reagisci quando si uniscono, abbandonano o aggiornano il loro stato.
Le policy di sicurezza a livello di riga decidono chi può unirsi a un canale privato e vengono controllate nuovamente quando il token viene aggiornato.
Richiedere che ogni canale di un progetto sia privato, qualunque sia la richiesta del cliente.
Pubblica da un server o da una funzione edge con una sola richiesta.
Un heartbeat rileva le connessioni inattive e il client si riconnette con backoff e jitter, quindi sottoscrive nuovamente i propri canali.
Segui lo stato della connessione, ottieni errori di trasporto con la fase non riuscita e scopri perché un canale è stato rifiutato.
Come funziona
L'SDK apre un WebSocket con il token dell'utente.
Partecipa a un canale; il server controlla l'accesso e conferma.
Su quel canale arrivano modifiche al database, trasmissioni e presenze.
Se il collegamento si interrompe, l'SDK si riconnette e si sottoscrive nuovamente.
Endpoint
Invia la chiave API del tuo progetto o il token dell'utente con ogni richiesta.
| Metodo | Punto finale | Descrizione |
|---|---|---|
| GET | /v1/realtime/ws | Apri la connessione WebSocket. I canali vengono multiplexati su di esso. |
| POST | /v1/realtime/broadcast | Invia una trasmissione su HTTP, senza WebSocket. |
Domande
postgres_changes su un canale con lo schema, la tabella e l'evento che desideri. Aggiungi un filtro per ricevere solo le righe corrispondenti. httpBroadcast() invia una trasmissione su HTTP. Anteponi al canale il tuo ID progetto quando lo chiami senza una sessione utente.Pronti per andare in diretta?
Il tempo reale è incluso in ogni progetto. Nessuna carta di credito richiesta.