跳转到主要内容
一个 WebSocket 同时传送行情数据和您账户的状态:您的余额,博彩公司和汇率,赛事、比分和比赛时钟,赔率,您所关注选项的投注单,以及您的订单。

登录

连接后 10 秒内,将 login 帧作为第一条消息发送:
服务器以 login_ok 回复其实际应用的内容:
connectionId 是标识此连接的 UUID。报告问题时请提供它。 登录被拒绝时,连接以 4001 关闭。一个连接只能登录一次:第二个 login 帧会收到 error 帧。

更改关注内容

无需重连即可添加或移除赛事、联赛和运动:
服务器以 subscribed 或 unsubscribed 回复,并附上当前生效的完整选择。频道在登录时确定,之后不能更改。

频道

bookmakers、currencies、fixtures、scores、clocks 和 odds 是行情频道:它们只传送变化,当前状态需从 /v1/{lang} 加载。balance、betslip 和 orders 是执行频道:它们传送您账户的状态。

消息封装

每条频道消息的封装都相同:
  • channel 和 type 告诉您如何读取 payload。
  • ts 是以毫秒为单位的 Unix 时间。在行情频道上,它是 Apexium 收到消息的时间;在执行频道上,是发送消息的时间。
  • seq 只出现在执行频道上。它为本连接的执行消息计数,每个新连接都从 1 重新开始。它不是恢复游标:请用 eventId 恢复 orders。
控制帧只有 type,没有 channel:login_ok、subscribed、unsubscribed、betslip_subscribed、betslip_unsubscribed、snapshot_required、reconnect 和 error。无论 receiveType 是什么,它们始终是 JSON 文本帧。 error 帧表示服务器无法应用某个帧,连接保持打开:
每个 error 帧都带有该连接的 connectionId,包括在 login_ok 之前或紧接在关闭之前发送的 error 帧。

限制

读取过慢的连接会以 4002 关闭。参见关闭代码。

心跳

服务器每 30 秒发送一次 WebSocket ping。客户端库会自动回复 pong。连续两次 ping 未得到回复的连接会被断开。您无需自己发送 ping。

重连

任何关闭之后都要重连,并使用指数退避加随机抖动:例如先等 1 秒,之后加倍,最多 30 秒,每次延迟乘以 0.5 到 1.5 之间的随机系数。抖动可以避免您的所有连接在同一时刻同时重连。 重连之后:
  • 行情频道。 从 /v1/{lang} 重新加载您所关注赛事的状态,然后应用消息。
  • orders。 带上 sinceEventId 登录,以接收您错过的内容。参见订单。
  • balance。 当前余额会紧接在 login_ok 之后到达。
  • betslip。 重新发送您的 subscribeBetslip 帧。
计划重启之前,服务器会发送 { "type": "reconnect", "reason": "server_restart" } 并以 1012 关闭:请立即重连。

语言

登录时的 lang 作用于 fixtures 频道:运动、联赛、状态、参赛方和场馆的名称在有翻译时使用该语言。它的取值与行情数据路径相同。其他频道只传送标识符和数字,标识符永远不依赖于语言。

博彩公司

odds 和 bookmakers 频道只传送 GET /v1/me 列出的博彩公司:您账户的博彩公司,对 API 关闭的除外。不含您任何博彩公司的消息不会发送。该列表变化后,已打开的连接会在几秒内跟上。