Default unidirectional SSE (EventSource) connection endpoint in Centrifugo is:
Only parts of EventSource spec that make sense for Centrifugo are implemented. For example
Last-Event-Id header not supported (since one connection can be subscribed to many channels) and multiline strings (since we are passing JSON-encoded objects to the client) etc.
Unfortunately SSE specification does not allow POST requests from a web browser, so the only way to pass initial connect command is over URL params. Centrifugo is looking for
cf_connect URL param for connect command. Connect command value expected to be a JSON-encoded string, properly encoded into URL. For example:
const url = new URL('http://localhost:8000/connection/uni_sse');
const eventSource = new EventSource(url);
Refer to the full Connect command description – it's the same as for unidirectional WebSocket.
The length of URL query should be kept less than 2048 characters to work throughout browsers. This should be more than enough for most use cases.
Centrifugo unidirectional SSE endpoint also supports POST requests. While it's not very useful for browsers which only allow GET requests for EventSource this can be useful when connecting from a mobile device. In this case you must send the connect object as a JSON body of a POST request (instead of using
cf_connect URL parameter), similar to what we have in unidirectional HTTP streaming transport case.
Supported data formats
Centrifugo sends SSE data like this as pings:
I.e. with event name
ping and empty data. You can ignore such messages or use them to detect broken connections (nothing received from a server for a long time).
Enables unidirectional SSE (EventSource) endpoint.
Default: 65536 (64KB)
Maximum allowed size of a initial HTTP POST request in bytes (when using HTTP POST requests to connect).
A basic browser example can be found here.