按比赛 ID 获取板球简版比分卡
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →根据必填的数字路径参数 `matchId`(默认 41881)返回一场板球比赛的简版比分卡。matchId 可从比赛列表、赛程、系列赛、球队赛程与赛果以及场馆比赛等接口获取。该接口没有查询参数,一次请求只返回一场比赛的一份快照。该接口没有留存探测调用记录,下列字段来自源响应示例,尚未经过实测验证;示例本身被截断,内容是 2021 年 ACC U19 亚洲杯中一场已完赛的 U19 一日国际赛(ODI)小组赛。示例包含两个顶层对象。`matchheader` 存放比赛背景:matchdesc、matchformat、state、status、seriesid、seriesname、matchstarttimestamp 与 matchendtimestamp(毫秒级时间戳)、winningteamid、revisedtarget、`team1` 与 `team2` 对象(teamid、teamname、teamsname)、`teamdetails` 对象(batteamid、batteamname、bowlteamid、bowlteamname)、`tossresults` 对象(decision、tosswinnerid、tosswinnername),以及名为 momplayers 和 mosplayers 的球员列表。`miniscore` 存放类似实时比赛的状态:batsmanstriker 与 batsmannonstriker(id、name、runs、balls、fours、sixes、strkrate)、bowlerstriker 与 bowlernonstriker(id、name、overs、maidens、runs、wickets、economy)、batteamscore(teamid、teamscore、teamwkts)、crr、ballsrem、curovsstats(当前这一回合的文字描述)、custstatus、event、inningsid、inningsnbr、inningsscores.inningsscore 列表(batteamid、batteamshortname、inningsid、runs、wickets、overs、balls、target、isdeclared、isfollowon)以及 lastwkt。示例中的部分取值只是占位:非主攻击球手条目被清零且名字为空,并且尽管比赛状态为 Complete,tossresults.decision 仍显示 'yet to be decided'、tosswinnerid 为 0。字段名大多为小写,但个别球员字段使用驼峰写法,请以真实响应为准核对字段名。这是一个概要视图,并非完整的逐局击球与投球明细表。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-miniscorecard API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-miniscorecard?key=<API_KEY>&matchId=41881'
查询结果
使用场景
- 在比赛预览抽屉或窄屏组件中展示简版比分,无需加载完整比分卡。
- 在简版比分卡上提供一个明确的展开入口,让想看逐局明细的用户跳转到完整比分卡。
- 为已关注的 matchId 渲染一行比分滚动条,把 batteamscore、crr 与状态说明组合在一起。
- 搭建追分进度跟踪,把击球方当前总分与局列表中的目标分进行对比。
- 读取关注比赛的 lastwkt 和 event 发出轻量的出局提醒,再链接到解说页面。
常见问题
简版比分卡和完整比分卡返回的内容有什么不同?
它返回的是紧凑摘要:一个比赛头信息,加上包含两名击球手、两名投球手、击球方比分、跑分率与各局总分的 miniscore 数据块。它不提供每名球员完整的击球与投球明细表,需要这些数据时请使用比赛详情分组中的完整比分卡接口。
哪个参数是必填的,matchId 从哪里获取?
只有 URL 路径中的数字 matchId 是必填项。可以从比赛列表、赛程、系列赛、球队赛程与赛果以及场馆比赛等接口获取。默认值 41881 是一场已完赛的 U19 一日国际赛(ODI)小组赛的示例标识。
这个响应经过探测调用验证了吗?
没有。该接口没有留存探测记录,源示例也被截断,因此字段清单尚未验证。在依赖这些字段之前,请用你自己的 matchId 取一份真实响应,核对字段名、大小写和取值类型。
为什么已完赛比赛的掷币结果在示例中显示 'yet to be decided'?
源示例中 tossresults.decision 为 'yet to be decided',tosswinnerid 为 0,而比赛状态却是 Complete。同一示例里还有一名被清零且名字为空的非主攻击球手。请把零值 id 和空名字当作没有数据,而不是真实取值。
如何读取各局总分和目标分?
inningsscores.inningsscore 是一个列表,条目包含 batteamid、batteamshortname、inningsid、runs、wickets、overs、balls 与 target。示例中第二局条目(54 分、10 人出局)排在第一局条目(194 分、9 人出局)之前,因此请按 inningsid 匹配条目,而不要依赖位置顺序。
支持分页或筛选吗?
不支持。文档中唯一的输入是 matchId 路径参数,没有用于选择某一局或裁剪字段的查询参数。想看另一场比赛,请更换 matchId 重新请求。
每场比赛都会返回数据吗?
不一定。覆盖范围因比赛而异,需要处理空响应或字段稀疏的情况。示例是一场已完赛的比赛,所以击球手、当前回合文字与 event 等字段在进行中的比赛里如何填充,这里并未验证。