使用说明
资料怎么引、接口怎么调、客户端从哪拿
亿兆体育整理的赛事统计与历史交锋资料，用来做赛后查阅、复盘分析和研究整理都顺手。署名怎么写、批量取数要注意什么、客户端上的更新提示是什么意思，下面按主题分成五条，哪条跟你有关就直接翻到哪条。
01
数据可以用在哪些场景
比赛刚结束，想马上确认射门次数、控球比例、传球成功率和红黄牌记录，直接查对应轮次的统计页最快。想把一段赛程连起来看，可以按球队、球员、轮次或时间区间去检索，把十几场的走势拉在一张表里比。
需要成体系的数据文件做图表、写稿，或者给社团成员发一份参考，可以下载单赛季打包资料，CSV、XLSX、PDF 三种格式任选，一个赛季的文件大约 18MB，用常用的表格软件就能打开。
把统计放进对外收费的图表、商业产品或者商业推广里，属于另一类使用。这类需求先通过咨询通道说明用途和用量，我们会给出对应的取数方式与时间安排。
02
引用与转载怎么写
引用一个数字、一张统计表或者一整份资料，把来源、赛季轮次和统计项一起写清楚就够了。下面这个格式可以直接照着套：
数据来源：亿兆体育数据服务中心
赛季轮次：本赛季第 29 轮
统计项：射门统计 / 控球率 / 红黄牌用于稿件、图表、公众号推文和社团内部分享，按上面的格式注明即可，不必另行申请。如果把整份资料改成自己的文件对外发布，或者交给第三方再分发，需要先联系我们把用途说清楚。
目前我们已经与 26 个省份的 140 余家球迷组织、校园足球社团建立了资料共享合作，社团内部使用走得很顺。署名格式拿不准的时候，直接问客服比来回改稿快。
03
接口调用与异常处理
数据接口日均调用 120 万次，把日常查阅和批量取数分开安排，取数过程会稳很多。下面几种情形照着做就行：
| 使用情形 | 建议做法 |
|---|---|
| 常规查阅 | 按需调用，一次取当前轮次需要的统计项，不必整轮拉取。 |
| 批量取数 | 集中在轮次更新窗口之外的时间段发起，避开录入高峰。 |
| 更新窗口 | 每轮结束后 90 分钟内，各项统计陆续入库，这段时间减少重复请求。 |
| 返回为空 | 先确认对应轮次是否已经发布，再决定要不要重试，避免连续空跑。 |
| 长期使用 | 通过咨询通道说明调用量级与用途，我们安排更合适的取数时段。 |
04
客户端获取与更新
客户端安装包统一从本站的赛事数据与客户端入口获取，提供 Windows、macOS、Android 三个版本，安装包平均 46MB。装好之后，常用数据页面的访问路径从 5 步压到 2 步，比赛刚踢完想连着看几场的时候省事不少。
- 收到新版本提示先退出客户端再安装更新，覆盖安装不会影响已经下载到本地的资料文件。
- 从哪里更新更新和首次获取走同一个入口，不用另找安装包，也不要使用来源不明的第三方包。
- 装不上怎么办先确认系统版本是否满足要求，再把设备信息和报错提示发到客服邮箱，工作日内会有回复。
- 换设备之后在新设备上重新走一遍入口即可，本地已下载的资料文件需要重新下载一次。
05
轮次与统计方式的标注
每一份资料和每一个统计页面都会把轮次、覆盖的赛事范围以及统计方式标出来，长这样：
本赛季第 29 轮 | 射门统计 | 覆盖 12 项赛事 | 赛后 90 分钟内入库
引用的时候把这几项一起带上，别人拿到同一行数据，看到的就是同一个意思。把不同轮次放在一张表里比较，记得在表头写清各自的轮次；做跨赛季的长周期图表时，写赛季阶段比只写年份更容易读懂。
历史交锋数据目前是 V4.2 版本。从 V1.0 到现在经历过四次结构升级，每一次改了什么，都写在赛事专栏的版本说明里。遇到两次取到的数字对不上，先看版本号是不是同一个，再联系我们。