Bỏ qua đến nội dung
ShopNexus Docs
Trên trang này Luồng gửi gì 1/2

GET /v1/stream là luồng server-sent events cho người gọi đã đăng nhập. App đang mở kết nối bằng bearer token như mọi lời gọi khác và giữ kết nối tới khi người dùng rời app. Push đi theo kênh riêng, mô tả ở Thông báo.

Luồng gửi gì

Luồng bắt đầu bằng sự kiện ready, sau đó mỗi thay đổi liên quan tới người gọi là một sự kiện:

Sự kiệnDữ liệuKhi nào
messageconversation_id, message_idcó tin nhắn mới mà người gọi được xem
readconversation_idngười bên kia đã đọc cuộc trò chuyện
dealdeal_idmột deal mà người gọi là người mua hoặc người bán vừa đổi
notificationnotification_idngười gọi có thông báo mới

Cứ 25 giây có một dòng comment để proxy không cắt kết nối.

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

App dùng thế nào

Sự kiện chỉ mang ID. Nhận sự kiện thì app tải lại thứ người dùng đang xem, thường là một lần gọi screen, và bỏ qua sự kiện không đụng tới gì trên màn hình.

Server không lưu sự kiện để phát lại, luồng cũng không nhận Last-Event-ID. Mất kết nối vì bất kỳ lý do gì thì app kết nối lại và tải lại mọi thứ đang hiện, vì có thể đã lỡ sự kiện. Server khi tắt sẽ chủ động đóng các luồng, app kết nối lại sang instance khác.

Một luồng tụt lại quá xa có thể bị rơi sự kiện, nên coi luồng là tín hiệu để tải lại, đừng coi nó là dữ liệu.

ShopNexus Docs
EN VI