Aurabase Logo
aurabasedocs
API/Realtime/Émettre un broadcast

Émettre un broadcast

POST/v1/realtime/{project_id}/broadcast

Envoie un événement à tous les clients abonnés à un canal. Indépendant de Postgres — fan-out via NATS, puis persistance best-effort.

#
Request

En-têtes

apikeyREQUIS
Clé API du projet
AuthorizationREQUIS
Bearer <JWT> — son project_id doit être celui de l'URL, sinon 403
Content-TypeREQUIS
application/json
#
Request

Body

channelstringREQUIS
Canal cible, obligatoirement préfixé du projet : {project_id}:{topic}. Un canal qui n'appartient pas au projet est refusé en 403.
payloadobjectREQUIS
Corps de l'événement, JSON sérialisable. Sa taille est bornée par la configuration du projet.
#
Notes

Forme du corps

Attention
Le corps n'a que deux champs : channel et payload. Il n'existe pas de champ event au premier niveau — si votre application en veut un, mettez-le dans payload.
#
Notes

Contrôle d'accès et limites

Attention
L'autorisation repose sur le JWT : son project_id doit correspondre à celui de l'URL, et le canal doit porter ce même préfixe. Il n'existe pas de table de policies allow_broadcast. Trois compteurs par projet peuvent répondre 429 : taille de charge utile, nombre d'événements, volume d'octets.
v1.0 · révisé 15 avr. 2026