订阅与取消 - AnySport

连接建立成功后，真正决定你会收到哪些数据的是订阅请求，不发送订阅，连接虽然存活但不会有任何业务推送。四种数据流（赛况/比分/滚球赔率/赛前赔率）的订阅请求都遵循同一套公共字段约定。

订阅请求公共 `data` 字段

适用于所有数据流的订阅请求（20000 / 20200 / 20100 / 20300）。

字段	必填	类型	说明
`api_key`	条件必填	string	握手 URL 未带 `api_key` 时必填；URL 已带则可省略
`match_id`	可选	string	只接收该比赛的推送；不传或 `null` 表示接收该产品全部推送
`league_id`	可选	string	联赛过滤（可选扩展字段）
`country_id`	可选	string	国家过滤（可选扩展字段）

两种典型订阅模式

全量订阅（match_id 传 null 或不传）：接收该产品下所有比赛的推送，适合需要展示”多场比赛聚合看板”的场景，比如全联赛比分墙。
单场订阅（match_id 传具体比赛 ID）：只接收指定比赛的推送，适合比赛详情页这类只关心一场比赛的场景，能显著减少客户端需要处理的消息量。

再次发送同数据流的订阅 code，会覆盖该产品旧 filter，无需重连。。
订阅失败（如无权限、已过期）返回 40301，不会断开连接，可修正后重试。

取消订阅请求字段

字段	必填	类型	说明
`code`	必填	int	对应产品的取消 code
`trace`	必填	string	追踪 ID
`data`	可选	object	可不传

具体每种产品的订阅示例与推送结构：

订阅实时比分

订阅 code 20200

订阅滚球赔率

订阅 code 20100

订阅实时赛况

订阅 code 20000

订阅赛前赔率

订阅 code 20300