Aurabase Logo
aurabaseمستندات
Aurabase Logo
aurabaseمستندات
واجهة برمجة التطبيقات/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

apikeyيتطلب
Clé API du projet
Authorizationيتطلب
Bearer <JWT> — son project_id doit être celui de l'URL, sinon 403
Content-Typeيتطلب
application/json
#
Request

Body

channelstringيتطلب
Canal cible, obligatoirement préfixé du projet : {project_id}:{topic}. Un canal qui n'appartient pas au projet est refusé en 403.
payloadobjectيتطلب
Corps de l'événement, JSON sérialisable. Sa taille est bornée par la configuration du projet.
#
ملاحظات

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.
#
ملاحظات

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