Notifications
The NotificationService provides real-time event delivery via server-sent events (SSE). Clients subscribe to a stream and receive notifications as they are published.
Service: firetiger.notifications.v1.NotificationService
Access: Read-write
Methods
| Method | Description |
|---|---|
| Subscribe | Open a server-streaming subscription for real-time notifications |
| Publish | Publish a notification to all active subscribers |
Subscribe
Open a long-lived server-streaming connection to receive notifications in real time. The server sends events as they arrive; the stream stays open until the client disconnects or the server closes it.
POST /firetiger.notifications.v1.NotificationService/Subscribe
REST alternative (SSE stream):
POST /v1/notifications:subscribe
| Field | Type | Required | Description |
|---|---|---|---|
organization_id |
string | No | Filter notifications to a specific organization. Defaults to the authenticated caller’s organization. |
curl -X POST "https://api.cloud.firetiger.com/firetiger.notifications.v1.NotificationService/Subscribe" \
-u "$USERNAME:$PASSWORD" \
-H "Content-Type: application/json" \
-d '{}'
Publish
Publish a notification. All active subscribers receive the event.
POST /firetiger.notifications.v1.NotificationService/Publish
REST alternative:
POST /v1/notifications:publish
| Field | Type | Required | Description |
|---|---|---|---|
notification |
object | Yes | The notification to publish |
curl -X POST "https://api.cloud.firetiger.com/firetiger.notifications.v1.NotificationService/Publish" \
-u "$USERNAME:$PASSWORD" \
-H "Content-Type: application/json" \
-d '{"notification": {"payload": "{}"}}'