获取百球大赛比赛的完整击球与投球记分卡
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 为受支持的百球大赛比赛搭建专属的完整记分卡页面。
- 验证专用于百球大赛的记分卡解析器,而不是在没有证据的情况下直接沿用标准记分卡的大小写、响应外层结构或每轮六球的计算方式。
- 为每位击球手填充包含得分、球数、四分球、六分球和击球率的击球表格,排序前先把 strkrate 字符串转换为数字。
- 在赛后报道里,用 outdec 文本在每位击球手旁边显示出局说明。
- 在重新请求比赛之前,先读取 ismatchcomplete 和 responselastupdated,判断缓存的记分卡能否视为终局。
常见问题
它需要哪个参数?
只需要 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 标记,包括媒体和方案相关字段。