获取 The Hundred 百球赛制的比赛解说
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →通过专门为 The Hundred 赛制比赛保留的路由返回解说,路径中传入 matchId,另可选传 iid(局次)和 tms(毫秒级 epoch 分页值)两个查询参数。这里列出的响应字段来自一个极简的源示例,并未经过实时调用验证。该示例包含 comwrapper 数组、inningsid、matchvideos 数组和 responselastupdated 值。其中 comwrapper 唯一的一项是空的占位解说对象:commtxt 为空,eventtype 为 NONE,inningsid 为 0,timestamp 为固定值,这正是没有解说内容的比赛所呈现的样子。默认的 matchId 41881 与标准解说接口使用的是同一个示例,因此该示例并没有展示一份有内容的 Hundred 解说数据流。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-commentaries-hundred API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-commentaries-hundred?key=<API_KEY>&matchId=41881'
查询结果
使用场景
- 在多赛制比赛中心里,把受支持的 The Hundred 赛事路由到这个按赛制区分的解说接口。
- 让 Hundred 解说适配器与标准赛制适配器相互独立,并在不套用每回合六球假设的前提下验证局次和 tms 的行为。
- 在直播比分应用中,当某场比赛只返回空占位条目时,显示解说暂未提供的状态。
- 在集锦配套页面中,当 matchvideos 数组有内容时,把相关视频引用放在 Hundred 文字解说旁边。
- 在规划统一的解说数据模型时,对比 Hundred 比赛数据流与标准赛制数据流在结构上的差异。
常见问题
什么时候该用它而不是标准解说接口?
当 matchId 属于以 The Hundred 赛制进行的比赛时使用它。标准解说接口是另一条独立的路由,而本接口是针对 Hundred 比赛的赛制专用路由。
它接受哪些输入?
路径中的 matchId 为必填;iid(局次 ID,例如 1)和 tms(取自返回条目 timestamp 字段的毫秒级 epoch 时间戳)是可选的查询参数。tms 留空则加载第一页。
为什么示例响应看起来是空的?
源示例只有一条占位条目:commtxt 为空,eventtype 为 NONE,inningsid 为 0,timestamp 为固定值。默认的 matchId 41881 并没有被说明是 Hundred 赛事,所以应把这个示例理解为空结果的结构,而不是一份真实的 Hundred 数据流。
它使用每回合六球的规则吗?
目录中没有说明 overnum 和 ballnbr 如何对应 100 球赛制,所以不要默认按每回合六球来理解。在围绕计分或回合逻辑搭建功能之前,请先用真实的 Hundred 比赛验证这些值。
matchvideos 字段里是什么?
它在源示例中是一个数组,而且是空的,所以其中各项的结构并未展示。请把它当作可选字段,在依赖具体的视频字段之前,先拿一场有内容的比赛核对。
每场 Hundred 比赛都有覆盖吗?
不要默认如此。覆盖情况取决于具体赛事,接口也可能返回空的占位条目,所以请妥善处理缺失或为空的解说。