概览 - AnySport

1. 概述

如果你的产品需要秒级刷新的比分牌、滚动更新的滚球赔率盘口，或是逐帧播报的比赛事件流，轮询 REST 接口的延迟可能无法满足需求。WebSocket 通过服务端主动推送来解决这个问题，只需建立一次长连接，声明你关心的数据产品，之后所有更新都会自动送达，无需客户端反复发起请求。

项目	说明
协议	WebSocket（JSON 文本帧）
运动类型	目前仅支持足球（握手参数 `business=soccer`）
路径	`/v1/ws/live`
生产地址	`wss://data.anysport.io/v1/ws/live`
WebSocket服务所需套餐	专业（$399 / 月）

握手成功后不会自动推送数据，需发送订阅消息并成功后才会收到推送。同一连接可同时订阅多种产品。

一条连接上可以按需订阅下面 4 种数据产品中的任意组合，每种产品有独立的订阅/取消 code 与推送 type，互不影响：

产品	订阅 code	订阅成功 code	取消 code	取消成功 code	推送 type
赛况	`20000`	`20001`	`21000`	`21010`	`situation_update`
比分	`20200`	`20201`	`21200`	`21210`	`score_update`
滚球赔率	`20100`	`20101`	`21100`	`21110`	`odds_live_update`
赛前赔率	`20300`	`20301`	`21300`	`21310`	`odds_prematch_update`

握手成功后不会自动推送数据，需发送订阅消息并成功后才会收到推送。同一连接可同时订阅多种产品。

字段必填说明约定：

wss://data.anysport.io/v1/ws/live?api_key={YOUR_API_KEY}&business=soccer

参数	条件	类型	说明
`api_key`	必填	string	API Key。可放在 URL，也可在订阅消息 `data.api_key` 中传。URL 与订阅消息至少一处必填。
`business`	必填	string	运动类型。当前仅支持 `soccer`（足球）。

过滤条件（league_id / country_id / match_id）请放在订阅消息的 data 中，不要写在 URL 上。

握手成功响应示例

{
  "type": "connected",
  "message": "WebSocket connected. Send subscribe message to receive data.",
  "timestamp": "2026-07-13T08:00:00.000Z"
}

此时连接已建立，但尚未开始推送业务数据。握手可能被拒绝（HTTP 层），例如：

建立连接

携带 API Key 完成 WebSocket 握手，收到 type: connected 表示连接已就绪。

发送订阅请求

针对你需要的数据产品发送对应的订阅 code，收到订阅成功应答后即开始接收推送。

维持心跳

每 30 秒发送一次心跳，避免因超时被服务端断开连接。

处理推送并做好断线重连

持续接收推送消息；连接意外断开时按指数退避策略重连，并重新发送订阅（订阅状态不会跨连接保留）。