获取 The Hundred 百球赛制的比赛解说

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

通过专门为 The Hundred 赛制比赛保留的路由返回解说,路径中传入 matchId,另可选传 iid(局次)和 tms(毫秒级 epoch 分页值)两个查询参数。这里列出的响应字段来自一个极简的源示例,并未经过实时调用验证。该示例包含 comwrapper 数组、inningsid、matchvideos 数组和 responselastupdated 值。其中 comwrapper 唯一的一项是空的占位解说对象:commtxt 为空,eventtype 为 NONE,inningsid 为 0,timestamp 为固定值,这正是没有解说内容的比赛所呈现的样子。默认的 matchId 41881 与标准解说接口使用的是同一个示例,因此该示例并没有展示一份有内容的 Hundred 解说数据流。

API 功能

The Hundred 专用路由 有一条专门服务于 The Hundred 的路径,客户端可以把 Hundred 的适配逻辑与标准赛制的解说调用分开,而不必把两种数据流混在一起。
可选的局次与 tms 输入 iid 和 tms 的可选方式与标准路由相同,滚动播报可以收窄到某一局,并通过传入毫秒级 epoch 时间戳来请求后续页面。
比赛视频列表字段 源示例在 comwrapper 旁边包含 matchvideos 数组,当比赛有相关视频时,Hundred 页面可以在这里查找对应的视频引用。
最近更新标记 源示例中出现了 responselastupdated 值和顶层的 inningsid,客户端可借此判断刷新后的数据是否带来了新内容。
安全的占位响应 没有解说的比赛可能只返回一条 commtxt 为空、eventtype 为 NONE 的空条目,因此在内容为空时响应结构依然可以预期。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

什么时候该用它而不是标准解说接口?

当 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 比赛都有覆盖吗?

不要默认如此。覆盖情况取决于具体赛事,接口也可能返回空的占位条目,所以请妥善处理缺失或为空的解说。

相关接口

相关指南

查看订阅方案 →