Skip to content
ShopNexus Docs
On this page What it sends 1/2

GET /v1/stream is a server-sent event stream for the signed-in caller. The open app connects with the usual bearer token and stays connected until the user leaves it. Push notifications travel on their own channel, covered in Notifications.

What it sends

The stream starts with a ready event, then sends one event per change that concerns the caller:

EventDataSent when
messageconversation_id, message_ida message the caller can see arrives
readconversation_idthe other member reads the conversation
dealdeal_ida deal the caller is buyer or seller in changes
notificationnotification_idthe caller gets a notification

A comment line arrives every 25 seconds so proxies keep the connection open.

event: deal
data: {"deal_id":"0192a4e1-..."}

How the app uses it

Events carry IDs only. On an event, the app reloads what the user is looking at, usually one screen call, and ignores events that touch nothing on screen.

Nothing is stored for replay, and the stream takes no Last-Event-ID. After any disconnect the app reconnects and reloads everything it shows, since it may have missed events. A server shutting down closes its streams on purpose, so the app reconnects to another instance.

Events can be dropped when a stream falls far behind, so treat the stream as a hint to refresh, never as the data itself.

ShopNexus Docs
EN VI