数据服务 · 接入流程

三条路径,把越位判罚数据变成可执行的工作流

火狐体育这套资料库把 18,640 条越位判罚条目、每条 24 个字段开放成三种用法:自己查、订阅推、按需定制。下面把三条路径各自拆成四个步骤,每一步都写清怎么做、容易错在哪、做完怎么确认。

  • 18,640 累计越位判罚条目 近三个赛季记录,按 S-2、S-1、当前赛季三档归档
  • 24 每条条目字段数 含轮次、发生时间点、判罚类型、介入方式、判罚耗时与定格帧说明
  • 90分钟 每轮赛后上线窗口 经双人复核后发布,有异议的条目保留原始记录并标注状态

路径一 · 入口开放

自助检索

公开页面直接筛,不需要提交任何信息

  1. 01选赛事与赛季
  2. 02定位轮次
  3. 03展开条目字段
  4. 04比对规则条文

路径二 · 节奏可控

订阅推送

先定颗粒度,再定推送节奏

  1. 01选定颗粒度
  2. 02设定推送节奏
  3. 03核对命中范围
  4. 04确认首次推送

路径三 · 按需交付

定制数据集

字段裁剪、口径约定与交付格式另议

  1. 01提出需求
  2. 02确认字段口径
  3. 03试跑校验
  4. 04交付与复核

路径一

自助检索:四个动作定位一条判罚

四个动作都在公开页面上完成,每做完一步,命中范围就收窄一层。步骤之间可以随时停下,不需要按顺序走完。

  1. 01

    选赛事与赛季

    筛选条先选赛事档:五大联赛、洲际俱乐部赛事、国内杯赛三档,合计 7 项赛事。再选赛季档 S-2、S-1 或当前赛季。两者同时落定后,条目数会立刻回显在筛选条下方。

    注意事项与结果确认

    注意只选赛事不选赛季,返回的是该赛事三个赛季的全量条目,跨赛季口径不同,不适合直接横向比较。

    确认回显条目数与所选档位一致;数字明显偏大时,先回头检查赛季档是否漏选。

  2. 02

    定位轮次

    把轮次轴上的游标移到目标轮次。常规赛季为 38 轮结构,赛程三分之二对应第 25 轮,轴上前段、中段、后段用三段不同灰度区分,跨过第 25 轮时灰度切换。

    注意事项与结果确认

    注意杯赛轮次与联赛轮次编号不同源,跨赛事比较之前先统一到赛季阶段,否则会拿第 6 轮去对第 6 轮的两套赛程。

    确认轮次数字与阶段标签同时高亮,列表里只剩该轮条目,上下轮次不再出现。

  3. 03

    展开条目字段

    点开任意一条条目,字段明细展开为 24 项:轮次、发生时间点、判罚类型、介入方式、判罚耗时、定格帧说明等。数值列使用等宽表格数字,可以直接抄录进自己的表格里比对。

    注意事项与结果确认

    注意标记为待复核的条目用虚线描边,原始记录不会被覆盖;后续更正会连同条目一起公开,引用时留意状态标签。

    确认字段明细完整出现 24 项,状态标签与上一步的筛选口径对应,没有混入其他轮次。

  4. 04

    比对规则条文

    把条目的判罚类型——进球被取消、进攻回合终止、干扰门将或防守球员、复核改判——拿到足球越位规则对照表里逐项比对。对照表按赛事与轮次分档,同一类型在不同赛事下的记法差异会并列给出。

    注意事项与结果确认

    注意对照表是对公开竞赛规则的整理,用于理解判罚依据,最终判定以竞赛官方结论为准,不能拿它当作判罚结果的替代。

    确认条文段落与条目里的判罚类型一一对应,没有出现跨档引用。完整读法见 使用教程

路径二

订阅推送:四种粒度各管一段

订阅不是把全部更新都送到你面前。先选颗粒度,再选节奏;粒度叠加越多,命中的范围越窄,推送也越少。

按赛事、轮次、判罚类型、球队四种订阅维度的切换示意,画面为冷调数据面板
四种维度可以叠加,叠加后取交集。

颗粒度选择

当前颗粒度:按赛事 · 五大联赛

命中示例:当前赛季第 25 轮至第 32 轮,越位判罚条目 258 条,其中待复核 4 条。

换成按判罚类型叠加后,同一区间的命中量会进一步收窄到单一类型。

  1. 01

    选定颗粒度

    四种粒度各有用途:按赛事适合跟进整档联赛;按轮次适合每轮赛后集中看一批;按判罚类型适合盯住复核改判这类少数情形;按球队适合追踪单一队伍的判罚走势,也可以先按积分区间分组再选队。

    注意事项与结果确认

    注意按球队订阅时要一并指定赛季档,否则会收到三个赛季的混流结果。

    确认所选粒度在左侧回显为一行文字,条目数与你的预期区间大致相符。

  2. 02

    设定推送节奏

    判罚条目属于轮次驱动的更新,每轮赛后 90 分钟内随复核结果上线,推送跟着这个窗口走。客场胜率与伤停补时属于指标类数据,每日刷新一次,跟随日更批次推送,不与轮次绑定。

    注意事项与结果确认

    注意把条目类与指标类放在同一条推送里,会让每轮的推送频次被日更带偏,建议分开设置。

    确认节奏设定后,你能说清哪一类内容在赛后触发、哪一类在固定日更时段触发。

  3. 03

    核对命中范围

    设置完成后先看回显,确认命中的条目数量与预期一致。同时选中两条粒度时取交集:例如「五大联赛」叠加「复核改判」,只会保留既属于该赛事档、又属于该判罚类型的条目。

    注意事项与结果确认

    注意命中数掉到个位数时,多半是两条粒度互斥,而不是数据缺失,换一条粒度再试即可。

    确认回显里的区间、赛事档与判罚类型三项都能对应上你的设定。

  4. 04

    确认首次推送

    首条推送落地后核对三件事:轮次编号是否正确、判罚类型标签是否与订阅一致、判罚耗时字段是否随条目出现。三项都对上,说明订阅口径已经跑通。

    注意事项与结果确认

    注意遇到标注为待复核的条目属正常状态,它在复核完成后会再触发一次状态更新,不必重复订阅。

    确认首条推送的字段结构与站内条目一致,没有多余的空白列。

路径三

定制交付:四步把口径对齐

当公开页面满足不了字段裁剪与口径要求时走这条路径。四个步骤都在向同一个方向收敛:先把口径谈定,再出数据。交付细节与验收标准写在 定制越位数据服务 一页。

  1. 01

    提出需求

    写清需要覆盖的赛事档、赛季档与轮次区间,并说明用途:媒体引用、研究样本,还是内部复盘。用途不同,字段的取舍顺序也不同。

    确认需求描述里赛事、赛季、轮次区间三项都落在明确档位上,没有出现「近期」「大概」这类模糊表述。

  2. 02

    确认字段与口径

    从 24 个字段里裁剪出需要的列,并逐项约定记法:判罚耗时以什么时点为起算、介入方式怎么缩写、待复核条目在交付文件里如何标注。

    确认字段清单逐列签字式确认完毕,每一列都有唯一的字段名与单位,不存在同名不同义。

  3. 03

    试跑校验

    先取一个轮次区间做小样本试跑,把结果与站内公开条目逐条比对。出现差异时标出差异项,回到上一步重新对齐口径,而不是直接改数字。

    确认试跑样本与公开条目逐条一致,差异项清零或已书面说明保留原因。

  4. 04

    正式交付与复核

    按约定格式交付,文件内保留复核标记列,便于接收方自行判断条目状态。后续公开记录出现更正时,已交付的数据包同步更新,更新范围与公开更正保持一致。

    确认交付文件能按字段名单独检索,复核标记列与站内条目状态一一对应。

异常处理

三类卡壳情况怎么往下走

条目缺失、数据存疑、口径不一致,是使用过程中最常遇到的三种卡壳。三类各自的处理动作与等待口径不同,混在一起提会拖慢处理。

  • 条目缺失

    先确认赛事档、赛季档与轮次三项是否都落定。每轮赛后 90 分钟是条目的上线窗口,窗口之内查不到属于正常状态。

    处理超过窗口仍未出现时,通过勘误通道提交赛事、轮次与比赛次序,不需要附截图以外的额外材料。

    口径工作日 9:00-18:00 受理,按提交顺序排队。

  • 数据存疑

    对某条条目的判罚类型或耗时存疑时,不要直接改用自己的数字。站点对存疑条目会保留原始记录,并标记为待复核。

    处理提交时写明条目编号与存疑字段,复核完成后该条目的更正记录一并公开,可在 更新日志 的复核与勘误分类下回溯。

    口径复核为双人流程,结论以条目状态更新为准,不单独出具说明。

  • 口径不一致

    多见于跨赛事对比:杯赛与联赛的轮次编号不同源,客场胜率与伤停补时属于日更指标,和轮次驱动条目不在同一批次。

    处理提交时注明比对口径与所引用的样本条目编号,先统一到赛季阶段再谈数值差异。

    口径口径类问题通常需要一次往来确认,答复走同一通道。

服务边界

哪些能自助,哪些需要人工介入

把请求分对类,是缩短等待时间最直接的办法。下面按自助与人工两组列出各自的覆盖范围和处理顺序。

可以自助完成

档位筛选与条目展开公开页面直接操作
榜单两列对比勾选后并排看差异项
轮次与判罚类型直达页头保留返回路径
订阅颗粒度与节奏设置含首次推送核对

需要人工介入

字段裁剪与口径约定走定制路径
勘误与更正登记走复核通道
跨赛季批量回溯需先定区间与字段
处理顺序勘误类优先于咨询类

三条路径不是互斥的。多数人从自助检索起步,看熟了字段与口径之后再决定要不要订阅,最后才考虑定制。想知道每个赛季阶段新增了哪些数据与功能,可以顺着 更新日志 的轮次节点往下读;想先弄清字段本身怎么读,从 使用教程 的三组共 12 章入手更省时间,也可以直接回到 首页 · 越位数据台 按赛事分档开始查。