登录
连接后 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 关闭的除外。不含您任何博彩公司的消息不会发送。该列表变化后,已打开的连接会在几秒内跟上。