获取百球大赛比赛的完整击球与投球记分卡

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

通过专为 The Hundred(百球大赛)赛制保留的路径,返回比赛记分卡。唯一的输入是放在 URL 路径中的 matchId。这里列出的响应字段来自一份被截断在 4000 个字符处的源示例,并未经过实时调用验证,因此截断位置之后的内容均属未知。示例中有 appindex 对象(seotitle、weburl)、ismatchcomplete 标记、数值型的 responselastupdated,以及 scorecard 数组。scorecard 的第一项展示了 ballnbr 和一个 batsman 数组,其中每位击球手都带有 id、name、nickname、runs、balls、fours、sixes、strkrate(字符串,例如 150 或 154.55)、outdec(出局说明文字)、iscaptain、iskeeper、isoverseas、imageid、inmatchchange、playingxichange,以及媒体或方案相关字段(videoid、videotype、videourl、premiumvideourl、planid、ispremiumfree、iscbplusfree)。截断的示例中看不到投球数据、额外得分和其他局的部分,所以不要想当然地认为它们存在。该示例对应默认的 matchId 40381,其标题描述的是 2021 年美国对爱尔兰的一场 T20I,因此它只能展示响应结构,并不是一份有数据的百球大赛记分卡;在构建计分或轮次逻辑之前,请先在真实的百球大赛比赛上核对数值。请把所有字段都当作可选字段处理。

API 功能

百球大赛专属完整记分卡路径 为 The Hundred 提供单独的完整记分卡请求,百球大赛的比赛页面可以保留自己的请求和解析器,而不必去调用标准赛制的记分卡接口。
逐位击球手的得分数据 示例中的每个 batsman 条目都带有 runs、balls、fours、sixes 和字符串形式的 strkrate,足够为列出的每位击球手填满击球表格中的一行。
outdec 中的出局说明 outdec 保存可读的出局说明文字,例如写明接杀球员和投球手的接杀描述;在示例里,尚未出局的击球手,该字段为空。
完成标记与更新时间戳 ismatchcomplete 和 responselastupdated 位于顶层,已保存的记分卡可以标注为终局或实时,并且只在比赛仍在进行时才重新请求。
球员 id 与角色标记 击球手条目包含 id、nickname 以及 iscaptain、iskeeper、isoverseas 标记,表格可以据此标出队长和三柱门守门员,并通过 id 把每一行链接到球员资料。
页面元数据区块 appindex 对象提供 seotitle 和 weburl 字段,可作为记分卡页面标题的现成字符串,你可以拿它与自己的比赛命名做对照。

在线 API 演示

GET /api/project/cricbuzz-cricket/match-details-get-scorecard-hundred

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-scorecard-hundred?key=<API_KEY>&matchId=40381'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

它需要哪个参数?

只需要 matchId,放在 URL 路径中。默认值为 40381。没有任何查询参数。

matchId 从哪里获取?

可从比赛列表、赛程、系列赛、球队或场地的比赛接口中取得。本路径请使用 The Hundred(百球大赛)比赛的 matchId。

响应里有哪些字段?

源示例展示了 appindex、ismatchcomplete、responselastupdated 和 scorecard 数组,数组的第一项列出了带有 runs、balls、fours、sixes、strkrate 和 outdec 的 batsman 对象。该示例被截断在 4000 个字符处,也没有经过实时调用验证,所以投球数据和其他部分未知。

示例展示的是真实的百球大赛记分卡吗?

不是。它对应默认的 matchId 40381,其标题描述的是 2021 年美国对爱尔兰的一场 T20I,因此只能说明数据结构。依赖字段数值之前,请先检查真实的百球大赛比赛。

可以直接复用我的标准记分卡解析器吗?

没有核对之前不要这样做。大小写、响应外层结构以及局数或球数的算术方式,并没有被证实与标准接口一致,所以在真实响应证明二者相同之前,请保留一个专用于百球大赛的解析器。

strkrate 是数字吗?

在示例中它是字符串,例如 150 或 154.55,所以排序或计算之前请先转换。示例并没有记录数字格式。

怎么判断比赛是否已经结束?

读取响应中的 ismatchcomplete;示例里它是 true。responselastupdated 是数值型时间戳,用来表示数据最近一次更新的时间。请在真实响应上确认它的单位,并把二者都当作可选字段。

所有字段都一定存在吗?

请把所有字段都当作可选字段。数据覆盖情况取决于具体比赛,示例中的许多取值是空字符串、零或 false 标记,包括媒体和方案相关字段。

相关接口

相关指南

查看订阅方案 →