Server sent events - Saba-sports/OddsDirectAPI_CN GitHub Wiki
表示此用户连接成功,并且每五秒会发送KEEPALIVE
表示仍在连接中。
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
- 若缓存中找不到可发送的更新数据,则会重新产生连线status
3
,且资料内容为初始数据,使用者应当使用该讯息之add
数据重新进行前端画面渲染