获取标准赛制板球比赛的精简 leanback 实时视图
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回单场板球比赛的精简实时视图(leanback),由必填的数字型路径参数 `matchId` 指定(默认值 40381)。matchId 可从比赛列表、赛程、系列赛、球队和场地的比赛接口中获得。本接口没有记录过实时调用,并且已保存的源示例在 `miniscore.inningsscores` 中间被截断,因此下列所有字段都未经验证,该位置之后的内容也看不到。示例是一场已结束的 T20 国际赛,顶层有两个部分。`matchheaders` 包含系列赛(seriesid、seriesname)、比赛描述与赛制、状态与状态文本、开始与结束时间戳、`team1` 和 `team2` 对象、含击球队与投球队 id 及简称的 `teamdetails` 区块、`tossresults` 区块、revisedtarget、winningteamid,以及由带 id、name、role 和图片 id 的球员条目组成的 `momplayers` 和 `mosplayers` 列表。`miniscore` 包含当前快照:batsmanstriker 和 batsmannonstriker、bowlerstriker 和 bowlernonstriker、batteamscore(teamid、teamscore、teamwkts)、crr、ballsrem、curovsstats、event、inningsid、inningsnbr 以及一个 inningsscores 列表。时间戳是毫秒级 epoch 时间,许多球队和球员字段是空字符串或零。百球大赛(The Hundred)有自己独立的 leanback 接口,本接口是标准赛制使用的路径。这里不保证响应比其他比赛详情接口更小,也不保证刷新更快。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-leanback API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-leanback?key=<API_KEY>&matchId=40381'
查询结果
使用场景
- 为选定的 matchId 驱动精简版比赛中心模式,页头说明和实时快照取自同一份响应。
- 让用户把精简视图展开为完整记分卡或文字解说页面,以 matchId 作为共用键,同时不承诺更小的响应体或更快的刷新。
- 在关注的比赛列表行中填入球队简称、来自 batteamscore 的击球队得分与出局数,以及来自 matchheaders 的状态语句。
- 在第二屏面板中用 curovsstats 展示近期投球标签,并为示例里出现的宽球标记等符号编写解析测试。
- 用 winningteamid、状态行和 momplayers 的第一个条目构建已结束比赛的卡片,列表为空时优雅回退。
常见问题
什么是 leanback 视图,什么时候使用?
目录将其描述为比赛的精简实时视图。它在一次响应中返回页头区块和当前快照区块,适合小型比赛面板。需要完整的击球与投球表格时,请改用记分卡接口。
需要哪些参数?
只需要 URL 路径中的数字型 matchId。可从比赛列表、赛程、系列赛、球队赛程与结果,以及场地比赛接口中取得。默认值 40381 是一场已结束的 T20 国际赛的示例标识。
响应经过实时调用验证吗?
没有。没有记录过实时调用,并且已保存的源示例在 miniscore.inningsscores 内部被截断。该位置之后的字段以及 inningsscores 条目的确切结构都未经验证,所以请用你自己的 matchId 核对真实响应。
它与百球大赛 leanback 接口有什么区别?
它们是各自独立的路径。本接口是标准赛制的路径,百球大赛 leanback 接口只用于百球大赛的比赛。请把两个解析器分开,不要假定字段完全一致。
为什么这么多球队和球员字段是空的?
示例中的 countryname、teamcolor、battingStyle 和 imageid 等字段是空字符串或零。数据覆盖情况因比赛而异,请把空值和零当作暂无数据,而不是真实数据。
示例来自一场正在进行的比赛吗?
不是。示例是一场已结束的比赛:state 为 Complete,状态文本为 Ireland won by 9 runs。对于进行中的比赛,快照数值会在两次请求之间变化;刷新节奏没有文档说明。