按比赛 ID 获取板球某一局的逐回合摘要
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回一场板球比赛的逐回合(over)摘要。路径参数 `matchId` 为必填(默认 41881),可从比赛列表、赛程、系列赛、球队和场馆比赛等接口获取。三个可选查询参数用来控制返回比赛的哪一部分:`iid` 是局编号(例如 1),`tms` 是分页游标,`restrictInningsId` 是布尔值。`tms` 留空时加载第一页;加载下一页时,传入以毫秒为单位的 epoch 时间戳(例如 1640883600000),该值取自本接口返回的 `timestamp` 字段。当 `restrictInningsId` 为 true 时,使用 `tms` 翻页会在 `iid` 指定的那一局开始处停止,并返回 HTTP 204,而不会继续翻到上一局。以上行为来自目录中的参数说明,由于该接口没有留存探测调用记录,因此尚未经过实测验证。该接口附带的源响应示例被截断且未经验证。可见部分取自一场已完赛的 U19 一日国际赛小组赛,先是一个 `matchheaders` 对象(matchdesc、matchformat、state、status、seriesid、seriesname、team1、team2、teamdetails、tossresults、winningteamid 以及比赛开始与结束时间戳),之后是一个 `miniscore` 对象(batsmanstriker、bowlerstriker、batteamscore、crr、curovsstats、custstatus、event、inningsid、inningsnbr、inningsscores、lastwkt)。每个回合的列表本身不在该截取片段中,请以真实响应确认回合字段名。示例使用复数键名 `matchheaders`,而简版比分卡的示例使用的是 `matchheader`。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-overs API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-overs?key=<API_KEY>&matchId=41881'
查询结果
使用场景
- 把 matchId 与目标局的 iid 组合起来,构建按局查看的逐回合摘要复盘页面。
- 把上一次返回的最后一个 timestamp 作为 tms 传回,分页加载很长的一局,而不是一次请求所有回合。
- 把 restrictInningsId 设为 true,将第二局的追分视图限定在该局内,并把 204 当作该局的结束。
- 制作回合列表,让每一行用该行自己的 timestamp 值链接到逐球详情页。
- 在预发布测试环境中用几场比赛试验分页和 restrictInningsId 的行为,再为正式比赛中心总结导航规则。
常见问题
这个接口返回什么?
目录将其描述为所选比赛某一局的逐回合摘要。被截断的源示例中可以看到 matchheaders 对象和 miniscore 对象,但看不到逐回合列表,请用你自己的 matchId 取一份真实响应来确认其字段名。
哪些参数是必填的?
只有数字类型的 matchId 路径参数是必填项(默认 41881)。iid、restrictInningsId 和 tms 都是可选的,文档中没有给出默认值,所以最简请求只发送 matchId 即可。
用 tms 翻页是怎么工作的?
tms 留空即加载第一页。加载下一页时,传入以毫秒为单位的 epoch 时间戳,取自本接口返回的 timestamp 字段。目录没有说明每页大小和排序规则,因此在自动化循环翻页之前,请先查看真实响应。
restrictInningsId 有什么作用?
为 true 时,使用 tms 翻页会在 iid 指定的那一局开头处停止,目录说明此时调用返回 204,而不是继续翻到上一局。请把 204 当作该局翻页结束,而不是失败。该行为在文档中有说明,但没有经过探测验证。
响应经过探测调用验证了吗?
没有。该接口没有留存探测调用记录,并且源示例在回合列表之前就被截断。在拿真实响应比对之前,请把所有字段名和翻页行为都视为未验证。
如何打开某一个回合的详情?
在回合详情接口中,把该回合的 timestamp 作为 tms,并带上相同的 matchId 与 iid。该接口要求提供 iid 和 tms,没有回合序号参数。
为什么这里的头信息键是 matchheaders,而简版比分卡里是 matchheader?
两个源示例对看起来属于同一类的比赛头信息数据块使用了不同的键名。在没有分别核对各接口键名之前,请不要让两者共用同一个解析器。