按比赛 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 功能

一次请求获得一份紧凑快照 只需要 matchId 这一个路径参数。响应把比赛头信息与类似实时的 miniscore 数据块合在一起,小型组件不必再拼接多个接口。
含球队、系列赛与赛果的头信息 matchheader 带有系列赛名称、比赛描述、赛制、状态与赛果说明,另有 team1 和 team2 对象,包含 teamid、teamname 以及 AFGU19 这类简短的 teamsname。
主攻与非主攻击球手数据 miniscore 数据块给出 batsmanstriker 与 batsmannonstriker 的得分、球数、四分球、六分球和击球率,每名球员都带 id,方便关联球员类接口。
当前投球手与经济率 bowlerstriker 和 bowlernonstriker 提供回合数、未失分回合、失分、拿下的出局数与经济率;示例中 overs 与 economy 以文本形式返回,无需完整比分卡也能画出投球栏。
各局总分与追分目标 inningsscores.inningsscore 列出每一局的得分、出局人数、回合数、球数与目标分,batteamscore 则给出当前击球方的比分与出局人数,可直接作为标题比分。
当前回合文字与最近一次出局 curovsstats 是当前回合的简短文字,custstatus 是一行状态说明,lastwkt 是最近一次出局的文字描述,适合用在滚动比分条或提醒中。

在线 API 演示

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

使用场景

常见问题

简版比分卡和完整比分卡返回的内容有什么不同?

它返回的是紧凑摘要:一个比赛头信息,加上包含两名击球手、两名投球手、击球方比分、跑分率与各局总分的 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 等字段在进行中的比赛里如何填充,这里并未验证。

相关接口

相关指南

查看订阅方案 →