PROD-23 // 订阅与数据能力总览
订阅赛事数据使用指南
天空体育赛事订阅对照数据提供基础公开数据、专业版与机构版三档方案，覆盖英超、西甲、德甲、意甲、法甲及中超等12个主流联赛，满足从实时比分查看到API数据接入的不同场景。
01 // PLAN MATRIX
订阅方案对比
三档方案共用同一套赛程对照数据源，差异集中在导出格式、近五场查询和API能力。
基础公开数据
赛程与比分阅读
面向普通球迷的基础服务，支持页面查看赛程对照与实时比分，覆盖平台全部12个联赛。
- 本赛季第23轮赛程对照
- 实时比分页面查询
- 赛事球队库基础筛选
按赛季开放
专业版
分析级导出
面向体育媒体与分析师的订阅方案，在赛程数据基础上开放完整导出索引与近五场战绩。
- 20项统计字段导出索引
- CSV / JSON 两种格式
- 球队近五场战绩查询
- 每日自动同步与人工复核
按赛季 / 按年订阅
咨询订阅机构版
API 数据服务
面向赛事运营机构和内容平台的接口方案，提供标准化API、沙盒测试环境与结构化数据字典。
- REST API 数据接口
- 沙盒测试环境
- 赛程、比分、球队档案字段
- 接口响应时间120ms内
按年签约
联系商务| 功能项 | 基础公开数据 | 专业版 | 机构版 |
|---|---|---|---|
| 覆盖联赛 | 12个主流联赛 | 12个主流联赛 | 12个主流联赛 |
| 赛程对照更新 | 每轮更新 | 每轮更新，2小时内同步 | 每轮更新，2小时内同步 |
| 数据校验 | 基础校验 | 每日同步 + 人工复核 | 每日同步 + 人工复核 |
| 导出格式 | 不支持 | CSV / JSON | JSON / 自定义 |
| 导出字段 | — | 20项统计字段 | 20项 + 数据字典 |
| 球队近五场 | 不支持 | 支持 | 支持 |
| 赛事球队库筛选联赛 | 基础筛选 | 区域快速折叠 | 区域快速折叠 |
| API 接口 | — | — | REST API |
| 沙盒测试 | — | — | 支持 |
| 适用对象 | 普通球迷 | 体育媒体 / 分析师 | 赛事运营机构 |
02 // USER GUIDE
订阅赛事数据使用指南
指南已更新，以导出索引分类为核心，可快速查询球队近五场战绩。
STEP 01 开通订阅与账号绑定
完成订阅后，系统自动开通对应方案权限。基础公开数据无需单独开通，注册后即可访问赛程对照与实时比分页面。
- 使用常用邮箱注册账号，推荐填写真实联系方式以接收同步状态通知。
- 专业版与机构版在订阅确认后，对应导出与API权限自动生效。
- 同一账号可在移动端与桌面端同时访问，数据保持一致。
STEP 02 导出索引快速入门
导出索引包含球队代码、轮次、比分、控球率、射门数等20项统计字段，按轮次与球队双维度排序。
- 在导出中心选择起始轮次与结束轮次。
- 按比赛日期或球队名称升序排列。
- 勾选需要的统计字段，生成索引文件。
- 以CSV或JSON格式下载到本地。
快速查询：选择球队后，系统自动列出该队近五场战绩，包含对手、主客场和比分。
STEP 03 赛事球队库筛选方法
赛事球队库筛选联赛功能支持按区域快速折叠。完成赛季中期维护后，可按欧洲、亚洲等区域快速定位联赛，再通过球队代码缩小范围。
数据库累计收录420多支球队与3.6万名球员档案，覆盖12个主流联赛；筛选结果可联动导出索引，直接生成对应球队的近五场战绩。
STEP 04 机构版API接入流程
机构版用户可在开发者资源页面申请沙盒密钥，通过标准REST请求获取赛程、比分和球队字段。
接口最近一次架构升级后，响应时间缩短至120ms内；沙盒环境使用历史赛程数据，不影响正式环境。
03 // LEAGUE FILTER
赛事球队库筛选联赛功能区
按区域折叠联赛列表，快速定位球队并查看近五场战绩。
欧洲区域
5个联赛- 英超ENG
- 西甲ESP
- 德甲GER
- 意甲ITA
- 法甲FRA
亚洲区域
1个联赛- 中超CHN
04 // EXPORT INDEX
导出索引下载中心
订阅赛事数据使用指南中的导出索引分类清晰，可快速查询球队近五场战绩。
索引字段说明
导出索引按轮次与球队双维度组织，共包含20项统计字段。常用字段如下：
- team_code球队代码
- round轮次
- score比分
- possession控球率
- shots射门数
- …完整字段以导出索引为准
CSV 字段顺序参考
# 专业版 CSV 导出，字段顺序为导出索引标准顺序 round,team_code,score,possession,shots
JSON导出时，字段名保持一致，并按轮次嵌套为数组结构，便于程序直接解析。
获取完整导出索引字段表05 // DEVELOPER
开发者资源
面向机构版用户的接口文档入口与沙盒测试环境说明。
API 接口能力
- 赛程对照数据接口：按轮次或日期获取天空体育大陆版站点赛程。
- 实时比分接口：返回当前轮次比分及比赛状态。
- 球队与球员档案：支持按联赛、球队代码检索。
- 导出索引数据下载：与专业版同一份数据源，按接口权限开放。
最近一次架构升级后，接口响应时间稳定在120ms内。
API 接入常见问题
沙盒测试环境说明
机构版签约后可申请独立沙盒密钥，用于验证请求参数、字段返回和频率限制。
- 测试数据采用历史赛程轮次，不与实时数据冲突。
- 沙盒接口字段与正式环境一致，切换时无需修改解析逻辑。
- 正式环境开通前，由数据团队核对调用域名与应用标识。