S'abonner à un canal

JWT utilisateur, passé en paramètre de requête (un navigateur ne peut pas poser d'en-tête sur un WebSocket).

Canal à rejoindre à la connexion. Il doit être préfixé du projet : {project_id}:{topic}. Sinon, envoyez un message subscribe après ouverture.

Version du protocole : 1.0.0 = JSON texte (défaut), 2.0.0 = en-tête binaire de 6 octets + charge JSON.

Filtres CDC : event (INSERT, UPDATE, DELETE ou *, défaut *), schema, table, filter.

Syntaxe colonne=op.valeur. Opérateurs : eq, neq, lt, lte, gt, gte, in, like, éventuellement préfixés de not..

self_broadcast (recevoir ses propres broadcasts, défaut false) et ack (accusé de réception, défaut false).

key — clé de présence permettant de suivre un même utilisateur sur plusieurs onglets.

Canal privé : une vérification d'autorisation est faite avant l'adhésion.

Info

Client → serveur : subscribe, unsubscribe, broadcast, presence_update, ping, access_token. Serveur → client : subscribed, event, pong, error, token_refreshed, broadcast_ack, presence_state.

Astuce

GET /v1/realtime/sse offre un flux unidirectionnel. Contrairement au WebSocket, il exige une clé API et déduit le projet de ?project_id= ou du préfixe de ?channel=.

Info

Les événements CDC héritent des policies RLS : un client n'est notifié que des changements sur les lignes qu'il peut lire. Le JWT est re-validé périodiquement (toutes les 5 minutes au plus) — envoyez access_token pour le renouveler sans rompre la connexion.