Databasewijzigingen
Abonneer u op invoegingen, updates en verwijderingen op een tafel zodra ze plaatsvinden.
Realtime
Eén WebSocket-verbinding draagt databasewijzigingen, uitgezonden berichten en aanwezigheid over. Privékanalen volgen dezelfde beveiliging op rijniveau als uw tabellen.
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()
Wat is inbegrepen
Abonneer u op invoegingen, updates en verwijderingen op een tafel zodra ze plaatsvinden.
Ontvang alleen de rijen die u interesseren, zoals room_id=eq.42. De server past het filter toe voordat de gebeurtenis wordt verzonden.
Verzend berichten tussen clients op een kanaal, met optionele serverbevestiging.
Volg gebruikers op een kanaal en reageer wanneer ze lid worden, weggaan of hun status bijwerken.
Beveiligingsbeleid op rijniveau bepaalt wie lid kan worden van een privékanaal en wordt opnieuw gecontroleerd wanneer het token wordt vernieuwd.
Vereisen dat elk kanaal van een project privé is, waar de klant ook om vraagt.
Publiceer vanaf een server of een edge-functie met één verzoek.
Een hartslag detecteert dode verbindingen, en de client maakt opnieuw verbinding met back-off en jitter, en abonneert zich vervolgens opnieuw op de kanalen.
Volg de verbindingsstatus, krijg transportfouten met de fase die mislukte en kijk waarom een kanaal werd geweigerd.
Hoe het werkt
De SDK opent één WebSocket met het token van de gebruiker.
Word lid van een kanaal; de server controleert de toegang en bevestigt.
Databasewijzigingen, uitzendingen en aanwezigheid arriveren op dat kanaal.
Als de link wegvalt, maakt de SDK opnieuw verbinding en abonneert zich opnieuw.
Eindpunten
Stuur bij elk verzoek de API-sleutel van uw project of het token van de gebruiker.
| Methode | Eindpunt | Beschrijving |
|---|---|---|
| GET | /v1/realtime/ws | Open de WebSocket-verbinding. Kanalen worden er overheen gemultiplext. |
| POST | /v1/realtime/broadcast | Verzend een uitzending via HTTP, zonder WebSocket. |
Vragen
postgres_changes op een kanaal met het gewenste schema, de tabel en het evenement. Voeg een filter toe om alleen overeenkomende rijen te ontvangen. httpBroadcast() verzendt een uitzending via HTTP. Voeg uw project-ID aan het kanaal toe als u het oproept zonder een gebruikerssessie.Klaar om live te gaan?
Realtime is bij elk project inbegrepen. Geen creditcard vereist.