频道
OddsPapi WebSocket 频道文档对它们作了整体说明。
先加载,再应用变化
行情频道只传送变化。它们从不发送赛事的当前状态。请分三步构建状态:1
连接并登录
打开连接,用您需要的频道和赛事登录。保留从此刻起到达的消息。
2
加载状态
从
/v1/{lang} 读取赛事及其赔率,例如 GET /v1/en/fixtures/odds。3
应用变化
在已加载的状态之上,先应用您保留的消息,再应用之后的每条新消息。
收到 snapshot_required 时重新加载
当 Apexium 无法保证您收到了每一个变化时,它会告诉您需要重新加载哪些频道:
/v1/{lang} 重新加载这些频道的状态,然后继续应用消息。以下情况会发生这种情形:
- 行情来源中断,Apexium 刚刚重新订阅。
- Apexium 落后于行情超过一秒:它会丢弃来不及发送的内容,而不是发送过时的价格,并要求受影响的客户端重新加载。
snapshot_required 之前发送的每条消息都比您重新加载的状态更旧。
一个连接每 10 秒最多收到一次 snapshot_required,以便您有时间重新加载。在这 10 秒内需要重新加载的频道,会在 10 秒结束时合并到一条 snapshot_required 中发送。
您会收到什么
odds和bookmakers只针对您fixtureIds中的赛事。关注某项运动或某个联赛不会带来其赔率。fixtures、scores和clocks针对您的fixtureIds,以及您tournamentIds和sportIds中的每场赛事。currencies发给订阅该频道的每个连接。- 博彩公司。 赔率只包含您账户的博彩公司,对 API 关闭的除外。不含其中任何一家的消息不会发送。
- 语言。
fixtures遵循您登录时的lang。参见语言。
- 在
fixtures上用该联赛的tournamentIds登录,或从/v1/{lang}读取其赛事。 - 发送
{ "type": "subscribe", "fixtureIds": [...] },带上您要交易的赛事,它们的赔率随即开始推送。 - 赛事结束后,为其发送
unsubscribe,以释放名额。
读取过慢会被关闭
Apexium 向每个客户端发送其能承受的数据量。发送缓冲区持续满载的连接会以4002 关闭,其他客户端不会因此变慢。参见关闭代码。
要跟上数据流:
- 使用
zstd。 它可将数据流缩小约四倍。参见编码。 - 在独立任务中读取。 快速解码并保存每条消息;把定价或数据库写入等耗时工作放到其他地方。
- 只关注您用到的内容。
fixtureIds中的每场赛事都会把它的赔率加入您的数据流。