问题排查 · 自助解答

数据对不上、导出卡住、引用格式拿不准,先从这里查

奇异果体育目前覆盖 5 大联赛与 12 项杯赛,累计 3800 场以上赛事档案与 2.4 万条球员档案。下面按使用中最容易卡住的六类情况分组:字段怎么算、什么时候更新、导出怎么排错、数据有差异怎么提、署名怎么写、账号怎么调。大多数问题照着步骤就能自己解决。

覆盖 5 大联赛与 12 项杯赛 · 前瞻比对更新至 2026 年 5 月

赛事档案
3800 场以上
球员档案
2.4 万条
联赛 / 杯赛
5 / 12
纠错响应
8 小时内

01 / 06

字段含义与统计范围

同一个比分在不同数据页上偶尔会差一两个百分点,多半是统计方式不同。这里说明我们采用的算法。

两组并排的赛事数据网格,同一场比赛的两种统计方式用颜色深浅区分,存在差异的单元格被荧光色圈出
同一场比赛的两种统计方式并列呈现,颜色深浅代表数值高低,荧光圈标出两边结果不同的位置。
控球率怎么算的?和别家差 1–3 个百分点正常吗?

控球率取的是全场有效比赛时间内各队的持球时长占比,补时、伤停和长时间中断单独记录,不摊进分母。外部来源如果把这些中断一并算进持球,数值就会比我们高出 1–3 个百分点,两边都算不上错。

每场比赛的记录里都跟着计时方式和来源行。写稿时把那行标注一并带上,读者就不会被两个数字弄糊涂。

进失球分布拆分到什么颗粒度?

按 15 分钟一个区间统计射门与进球,同时标出进攻发起的位置区间,配合控球率可以看出球队在哪一段时间被压住。单场平均整理 26 个数据字段,字段说明随名录版本一起更新;字段改名时旧名称会保留一个版本过渡,手上的脚本不会突然报错。

球员名录里的号码和当场首发对不上,先查哪一步?

先确认这场比赛落在哪个月度版本里。球员名录按月发布,赛季中期的转会、临时改号和青年队上调都累计到下一个月度版本,中间不会单条零散改动。

急着核实的话,拿当轮前瞻公布的那份名单,和赛后复盘里的首发做一次对照;两边仍然不一致,就按第 04 组的方式提交给我们处理。

球队简史和球衣号码沿革在哪里看?

本期完成了 12 家俱乐部的简史与球衣号码变更比对,每家一页档案,按赛季阶段排列号码沿革。想看某家俱乐部,到专题中心按队名查找连载即可。

常用字段速查
字段 含义 数值最容易差在哪里
控球率 有效比赛时间内的持球时长占比 中断时间是否计入分母
进失球分布 15 分钟区间的射门与进球位置 补时进球算进哪个区间
首发名单 开场哨响时在场的球员 赛前最后时刻的临时调整
球衣号码 按月度版本记录的号码沿革 赛季中期的改号尚未发布

引用时按第一列的名称照抄,别改写成近义词,搜索和交叉对比都能对上。

02 / 06

更新节奏与延迟处理

什么时间能看到什么数据,以及等太久的时候该做什么。

比赛结束后多久能拿到比分和进失球分布?

终场哨响后 30 分钟内更新比分与进失球分布,先出比分,再补射门位置。凌晨的夜场同样按这个节奏走,值班的校对人员在 6 个城市轮班覆盖。

控球率为什么比比分慢?

控球率要逐段计时,一般在赛后 2 小时内补齐。如果在比分刚更新时就导出,文件里的控球率字段是空的;等明细上线后重新导出一次即可,文件名里的批次号会跟着变。

球员名录多久发布一版?

按月发布,通常在每月 5 日前后上线。这样团队内部的引用版本不会来回跳,一份名单能稳定用上一个月。

前瞻和复盘什么时候出?

每周发布 3 期赛程前瞻,覆盖即将开始的一轮;每轮赛事结束后 24 小时内发布复盘,把前瞻里写下的判断和赛后的实际数据放在同一张对照表里。

赛程按赛季阶段拆成三轮循环,第二轮、第三轮的前瞻会直接引用上一轮复盘的结果,连着看能看出球队状态的变化曲线。

某场比赛超过 2 小时还没更新,怎么办?

先看一眼这场球挂在赛程表的哪一天——跨时区赛事偶尔会按当地日期记在相邻一天。确认日期无误后,带着联赛、轮次和开球时间走纠错通道,卡住的场次会被优先处理。

03 / 06

导出与数据接口

拿到数据之后怎么用,选错格式和筛错维度是最常见的两个坑。

JSON 和 CSV 该选哪个?

交给程序读的用 JSON,字段结构完整、带批次号;给表格用的选 CSV,一行一条记录,直接打开不乱码。两种格式的字段名一一对应,来回切换不会丢信息。

能按什么维度筛数据?

按联赛、赛季阶段、俱乐部三个维度筛。赛季阶段可以直接选循环序号,取“本赛季第 2 轮循环”的赛程命中范围最准。记录量大的时候按维度分批导出,比一次拉全量更稳,出问题时也容易定位在哪一批。

导出失败或者条数不对,按什么顺序查?
  1. 看筛选区间有没有跨赛季阶段,跨阶段的记录要分两次导出。
  2. 把俱乐部简称换成档案里的全称,简称在筛选条件里命中不到。
  3. 换一个浏览器或关掉下载拦截插件,确认是不是本地拦了下载。
  4. 以上都正常还失败,把筛选条件和报错时间发给客服,我们查服务端日志。
数据接口怎么开通?

数据接口在 2024 年开放,随年度授权开通,开通时会给到调用凭证、字段清单和并发说明。接口返回的字段与 JSON 导出完全一致——先用接口拉一批数据做验证,确认无误再接到生产环境。

04 / 06

纠错与更正

发现数据对不上,交给我们之前先把这几样准备好,处理会快很多。

横向流程条从提交纠错到受理再到发布更正说明,三个节点用发光圆点标注,末端标出响应时限刻度
提交 → 受理 → 更正发布:一般问题 8 小时内响应,涉及多个字段的更正 24 小时内发出说明。
提交纠错要带哪些信息?

联赛与轮次、对阵双方、开球时间、出错字段现在的值、你认为应该是什么值,再加上依据来源——官方战报链接、转播画面的时间点、俱乐部公告都可以。一段文字加一个链接就够,不用整理成表格。

多久能有结果?

一般问题 8 小时内响应,会明确告诉你采纳还是不采纳,以及判断的理由。涉及多个字段、或者跨轮次的差异,24 小时内发布更正说明,说明里写清改了什么、波及哪些批次。

更正发布以后,我已经导出的文件怎么办?

重新导出一份对应批次即可。导出文件名里带着批次号,新旧两份放在一起,一眼能看出哪份是更正后的。稿子已经发出去的,建议在文末补一行更正备注,链接到更正说明。

团队里几个人引用同一场数据,版本对不上怎么处理?

每次导出都带批次号,来源行里写上批次号,后来的人按这个号就能找到同一份数据。团队内部协作统一在一份批次上推进,返工基本就没了。

05 / 06

引用与转载

署名怎么写、整篇转载找谁、版权问题从哪里提,都在这一组。

写稿引用比分和赛程,来源行怎么写?

保留品牌名和批次号就行,例如“数据来源:奇异果体育 · 本赛季第 2 轮循环批次”。批次号在导出文件和页面底部的来源行里都能看到。

想整篇转载复盘或俱乐部档案,走什么流程?

常规篇幅的摘引,保留来源标注即可;整篇转载、批量引用名录,或者把数据接进你自己的产品,需要一份授权说明。说明里写清用途、发布平台和预计用量,发送到客服邮箱,一般两个工作日内回复。署名方式和改动范围在使用协议里有完整条款。

遇到侵权怎么提?

版权申诉走客服邮箱,附上原文链接、你的权属说明和希望的处理方式。我们会先做权利确认,再决定撤下内容、补署名还是补授权,处理结果会回邮件告知。

06 / 06

账号与服务包

订阅方式、席位调整和内容拆分,这一组解决。

个人订阅和团队授权怎么选?

个人和小型球迷社群按月付订阅就够,拿到的是网页端的完整数据与常规导出。媒体编辑部、俱乐部内容团队这种多人协作、要用接口和批量导出的,选年度授权,附带调用凭证和字段清单。

一份授权能几个人用?

年度授权按团队席位开通,席位数量在你确认人头数之后写进授权文件;中途增减席位不用重签,跟着续期一起调整就行。

内容可以只买一部分吗?

赛程、球员名录和前瞻复盘可以分开订阅。只关心比分和赛程的编辑团队,或者主攻阵容沿革的档案团队,都能只选自己用得上的那块。想先看全貌再决定,平台服务页里每块内容包含哪些字段、多久更新一次都写得很细。

订阅时填的联系信息会怎么用?

联系信息只用于答复你提出的问题和递送授权文件,处理方式见数据保护说明;账号与订阅的变更记录跟着授权文件走。

到这里还没解决,按类型找人最快

每一类问题都有对应的入口,把来意写清楚能省掉一轮往返。联系方式在找到我们页顶部。

数据差异 / 赛程纠错

带上场次和依据

把联赛、轮次、开球时间和依据来源放在一起提交,纠错通道全天接收。一般问题 8 小时内响应,涉及多个字段的更正当天也会给出处理方向。

提交纠错

授权与引用

说清用途和用量

整篇转载、批量引用名录、把数据接进产品,发一封说明用途、发布平台和预计用量的邮件,两个工作日内回复。署名规则可以先看条款。

查看使用协议

账号与订阅

电话来得更快

席位调整、续期、授权文件补发这类事直接打电话,工作时间内基本能当场确认。客服邮箱受理数据核对与版权申诉,同样写清来意即可。

找到我们