Server sent events - Saba-sports/OddsDirectAPI_CN GitHub Wiki

Keep alive

表示此用户连接成功,并且每五秒会发送KEEPALIVE表示仍在连接中。

Status Enumeration

status状态代码 message显示讯息 Description说明描述
0 Success 成功
1 InitialData 初始数据
3 Reset 重新连接
97 Invalid Accept-Encoding Http Status Code = 400
无效的編碼压缩格式
98 Invalid OData query attributes Http Status Code = 400
Odata查询属性无效或不支援
99 System under maintenance Http Status Code = 503
系统正在维护中
100 Internal Server Error Http Status Code = 500
服务器发生非预期错误
  • 第一次连线成功会回传status 1, add为初始数据,使用者应当使用该讯息之add数据进行前端画面渲染; 接着陆续收到status0的更新數據add/change/remove

  • 若中途使用者因网路问题或者其他因素断线:
    • 如果是使用 browser 的 native javascript EventSource api,不关闭页面的情境下 browser 会自动重连并且自动在 header 带入 Last-Event-Id, Server 端会根据该 Last-Event-Id 透过内部资料缓存机制尝试发送该重连之 client 遗漏的更新数据
    • 如果是其他语言开发的使用者, 需自行实作重新连线机制且于header带入Last-Event-Id
    • 若缓存中找不到可发送的更新数据,则会重新产生连线status3,且资料内容为初始数据,使用者应当使用该讯息之add数据重新进行前端画面渲染
⚠️ **GitHub.com Fallback** ⚠️