获取百球大赛比赛的精简 leanback 视图
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →通过专为 The Hundred(百球大赛)赛制保留的路径,返回一场比赛的精简 leanback(沙发视图)摘要。唯一的输入是放在 URL 路径中的 matchId。这里列出的响应字段来自一份被截断在 4000 个字符处的源示例,并未经过实时调用验证,因此截断之后的内容未知。示例包含两个顶层对象。matchheaders 带有 matchdesc、matchformat、matchstarttimestamp、matchendtimestamp、seriesid、seriesname、state、status、winningteamid、revisedtarget、livestreamenabled、alerttype,team1 与 team2 对象(teamid、teamname、teamsname 和旗帜字段),teamdetails(batteamid、batteamname、bowlteamid、bowlteamname),tossresults,以及 momplayers 与 mosplayers 球员列表(含 id、name、role 和 faceimageid)。miniscore 则承载当前或最终的比分快照:batsmanstriker 与 batsmannonstriker(runs、balls、fours、sixes、strkrate),bowlerstriker 与 bowlernonstriker(overs、maidens、runs、wickets、economy),batteamscore(teamid、teamscore、teamwkts),以及 crr、ballsrem、event、inningsid、inningsnbr 和 inningsscores.inningsscore 列表(含 balls、batteamid、batteamshortname、inningsid、isdeclared、isfollowon、overs 和 runs)。示例中 matchformat 的取值是 HUN,而 matchdesc 和 seriesname 描述的却是一场 T20I 系列赛,overs 19.6、balls 120 这样的局内数据看起来也是六球一轮,所以请用它来了解响应结构,并在真实的百球大赛比赛上核对数值。请把所有字段都当作可选字段处理。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-leanback-hundred API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-leanback-hundred?key=<API_KEY>&matchId=40381'
查询结果
使用场景
- 用百球大赛专用的 leanback 请求支撑精简的比赛中心视图,而不必加载完整的记分卡。
- 在真实的百球大赛比赛上核实实际结构之前,让百球大赛的精简展示与标准赛制的字段假设保持隔离。
- 根据 matchheaders 里的 state 和 status 值,为关注的百球大赛比赛渲染小组件或锁屏风格的状态行。
- 在配合电视直播的二屏伴侣应用里,用 miniscore 展示当前的击球手和投球手。
- 为已结束的比赛填充结果卡片,写入获胜球队、各局比分和奖项球员,再链接到完整记分卡接口查看详情。
常见问题
它需要哪个参数?
只需要 matchId,以数字形式放在 URL 路径中,可从比赛列表、赛程、系列赛、球队或场馆的比赛接口获得。默认示例值为 40381,没有任何查询参数。
什么是 leanback 视图?
它是目录中描述的 The Hundred 赛制的比赛 leanback,即精简的比赛摘要。在源示例中,它把比赛头信息与 miniscore 快照合并在一起,与体量更大的记分卡和解说路径形成对比。
响应里包含哪些字段?
源示例展示了 matchheaders(比赛描述、赛制、时间戳、系列赛、状态、球队、掷币结果、奖项球员)和 miniscore(击球手、投球手、球队比分、当前跑分率、各局比分)。示例被截断在 4000 个字符处,也没有经过实时调用确认,因此可能还有更多字段。
示例能证明百球大赛的计分规则吗?
不能。示例中的 matchformat 是 HUN,但描述和系列赛文字却指向一场 T20I,而 overs 19.6、balls 120、ballsrem -20 这样的数值看起来是六球一轮。依赖这些数字之前,请先在真实的百球大赛比赛上核实。
已经结束的比赛也能用吗?
示例就是一场已结束的比赛,state 为 Complete 并带有赛果状态,此时 miniscore 保存的是最终快照,所以可以做结果卡片。直播中的比赛是否按同样的字段更新,示例并未展示,请在实际的直播比赛期间测试。
什么时候该用它而不是标准的 leanback 接口?
当 matchId 属于以 The Hundred 赛制进行的比赛时使用它。这是针对该赛制的专用路径,能让百球大赛的视图避免沿用标准赛制的字段假设。
所有字段都一定存在吗?
不要这样假设。示例中的许多值是空字符串或零,例如 tossresults 和若干图片 id,而且数据覆盖情况取决于具体比赛,所以请妥善处理缺失或为空的值。