获取百球大赛比赛的精简迷你记分卡
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →通过专为 The Hundred(百球大赛)赛制保留的路径,返回一场比赛的精简迷你记分卡。唯一的输入是放在 URL 路径中的 matchId。这里列出的响应字段来自一份被截断在 4000 个字符处的源示例,并未经过实时调用验证,因此截断位置之后的内容均属未知。示例包含两个顶层对象。matchheader 带有 matchdesc、matchformat、matchstarttimestamp、matchendtimestamp、seriesid、seriesname、state、status、winningteamid、revisedtarget、livestreamenabled 和 alerttype,还有 team1 与 team2 对象(teamid、teamname、teamsname 及 flag 相关字段)、teamdetails(batteamid、batteamname、bowlteamid、bowlteamname)、tossresults(decision、tosswinnerid、tosswinnername),以及 momplayers 与 mosplayers 两个球员对象列表(含 id、name、role、faceimageid 和 teamname)。miniscore 承载比赛快照:batsmanstriker 与 batsmannonstriker(runs、balls、fours、sixes、strkrate)、bowlerstriker 与 bowlernonstriker(overs、balls、maidens、runs、wickets、economy、rpb)、batteamscore(teamid、teamscore、teamwkts)、crr、ballsrem、custstatus、event、inningsid、inningsnbr,以及 inningsscores.inningsscore 列表,其条目以 balls、batteamid、batteamshortname、inningsid 和 isdeclared 开头。该示例的 matchformat 为 HUN,但 matchdesc 和 seriesname 描述的却是一个 T20I 系列赛,其 inningsscore 显示 120 球,超过了一局 100 球的上限,并且把 inningsid 2 与 inningsnbr 1st inn 配在一起,所以只应把它用来了解数据结构,具体数值需要在真实的百球大赛比赛上核对。在这个示例中,头部对象的名称是 matchheader(单数);与其他精简比赛视图共用解析器之前,请先确认这个名称。请把所有字段都当作可选字段处理。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-miniscorecard-hundred API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-miniscorecard-hundred?key=<API_KEY>&matchId=40381'
查询结果
使用场景
- 为选定的比赛填充一个精简的百球大赛记分卡面板。
- 提供从迷你面板跳转到百球大赛完整记分卡接口的入口,同时不要假定两个响应的字段完全一致。
- 为关注的比赛驱动一行比分条,显示球队得分、出局数、当前跑率以及场上的击球手。
- 利用 state、状态文本、winningteamid 和获奖球员列表,为已结束的比赛搭建结果卡片。
- 在信任各字段组合之前,先用示例中的特殊情况(例如 HUN 赛制与 T20I 标签并存、inningsid 2 与 1st inn 并存)来测试百球大赛组件的解析器。
常见问题
它需要哪个参数?
只需要 matchId,放在 URL 路径中。默认值为 40381。没有任何查询参数。
matchId 从哪里获取?
可从比赛列表、赛程、系列赛、球队或场地的比赛接口中取得。本路径请使用 The Hundred(百球大赛)比赛的 matchId。
响应里有哪些字段?
源示例展示了 matchheader 对象(球队、系列赛、状态、状态文本、掷币、获奖球员)和 miniscore 对象(击球手、投球手、球队得分、crr、ballsrem、event、各局比分)。该示例被截断在 4000 个字符处,也没有经过实时调用验证,所以后面的字段未知。
这个示例能证明百球大赛的计分规则吗?
不能。matchformat 虽然是 HUN,但示例描述的是一个 T20I 系列赛,其 inningsscore 显示 120 球,inningsid 2 与 inningsnbr 1st inn 并存。请只把它用来了解字段名称,数值要在真实的百球大赛比赛上核对。
它与百球大赛完整记分卡有什么区别?
本接口是精简快照,包含头部、场上这一对球员和各局总分。完整记分卡接口返回每位击球手的数据行,是另一份独立的响应,所以不要假定两者的字段完全一致。
可以用它查询已结束的比赛吗?
示例描述的是一场已完成的比赛(state 为 Complete,并带有比赛结果状态文本和获胜球队 id),所以已结束的比赛可以返回结果快照。其他状态会返回什么内容,目前尚未得到确认。
所有字段都一定存在吗?
请把所有字段都当作可选字段。数据覆盖情况取决于具体比赛,示例中的许多取值是空字符串、零或 false 标记,例如掷币的 decision 显示的是 yet to be decided。