获取百球大赛比赛的精简 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 功能

单参数精简视图 只需要 matchId,百球大赛的小组件或二屏卡片仅凭一个路径值就能加载整份摘要,无需管理局次、球员或分页等任何输入。
比赛头信息区块 源示例中的 matchheaders 对象给出 state、状态文本、比赛描述、开始与结束时间戳以及 seriesid 和 seriesname,足够用来生成卡片标题和一行状态说明。
球队与赛果标识 team1、team2、teamdetails 和 winningteamid 提供 teamid、teamname 以及球队简称,客户端可以把摘要与自己的球队记录关联起来,并为已结束的比赛标出获胜一方。
Miniscore 击球与投球快照 miniscore 列出主攻与非主攻击球手的 runs、balls、fours、sixes 和 strike rate,两位投球手的 overs、runs、wickets 和 economy,另外还有 crr 以及球队总分与出局数。
分局比分列表 inningsscores.inningsscore 数组为每一局提供一个条目,含 batteamshortname、runs、overs 以及 isdeclared、isfollowon 等标志位,适合用来拼出精简的比分行。
奖项球员列表 momplayers 和 mosplayers 包含带有 id、name、role 和 faceimageid 的球员对象,列表有数据时,结果卡片就能点出已结束比赛的最佳球员。

在线 API 演示

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

使用场景

常见问题

它需要哪个参数?

只需要 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,而且数据覆盖情况取决于具体比赛,所以请妥善处理缺失或为空的值。

相关接口

相关指南

查看订阅方案 →