Cập nhật trực tiếp
Luồng server-sent events báo cho app đang mở biết có gì thay đổi, và cách app dùng nó.
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ện | Dữ liệu | Khi nào |
|---|---|---|
message | conversation_id, message_id | có tin nhắn mới mà người gọi được xem |
read | conversation_id | người bên kia đã đọc cuộc trò chuyện |
deal | deal_id | một deal mà người gọi là người mua hoặc người bán vừa đổi |
notification | notification_id | ngườ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.