建立连接 - AnySport

建立 WebSocket 连接是整个接入流程的第一步。完成握手之后，连接本身已经就绪，但不会自动开始推送数据，你还需要按照订阅与取消订阅的说明发送订阅请求才能收到业务推送。

握手 URL

握手URL

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

参数	必填	类型	说明
`api_key`	条件必填	string	API Key。可放在 URL，也可在订阅消息 `data.api_key` 中传。URL 与订阅消息至少一处必填。

把 API Key 放在握手 URL 上是最简单的方式，之后所有订阅请求都可以省略 data.api_key；如果出于安全考虑不希望 Key 出现在 URL / 日志里，也可以握手时不带，在每次订阅请求的 data.api_key 中单独传递。

过滤条件（league_id / country_id / match_id）请放在订阅消息的 data 中，不要写在 URL 上。URL 只负责身份认证，具体订阅哪些数据、过滤哪场比赛，是通过后续的业务消息声明的。

握手成功响应示例

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

此时连接已建立，但尚未开始推送业务数据。收到这条消息后，下一步就是发送订阅请求。

握手阶段如果被拒绝，会在 HTTP 层直接返回对应状态码，连接不会建立成功，因此客户端需要在发起连接的代码路径上单独处理这些情况，而不能寄希望于在 WebSocket 消息里收到错误详情：