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

用 iid 按局筛选 可选参数 iid 接受局编号(如 1),让回合摘要视图只聚焦比赛的某一局,而不必展示整场比赛的完整列表。
用时间戳游标查看更早的回合 第一页时 tms 留空,翻下一页时传入毫秒级 epoch 值。游标取值来自本接口自己返回的 timestamp 字段。
在局边界处停止翻页 把 restrictInningsId 设为 true 后,翻页会停在 iid 所指那一局的开头,目录中说明此时返回 204,而不会继续翻回上一局。
比赛头信息与迷你比分背景 源示例以 matchheaders 和 miniscore 对象开头,页面可以在回合列表旁边展示球队、系列赛、赛果文字以及当前各局总分。
为回合下钻提供时间戳 这里返回的 timestamp 值就是单回合详情接口所需的 tms 输入,因此每一行回合摘要都能链接到它自己的详情请求。
一个必填 ID,三个可选控制项 只有 matchId 是必填的。iid、tms 和 restrictInningsId 都可以省略,所以针对某场比赛的首次请求只需要一个路径值。

在线 API 演示

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

使用场景

常见问题

这个接口返回什么?

目录将其描述为所选比赛某一局的逐回合摘要。被截断的源示例中可以看到 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?

两个源示例对看起来属于同一类的比赛头信息数据块使用了不同的键名。在没有分别核对各接口键名之前,请不要让两者共用同一个解析器。

相关接口

相关指南

查看订阅方案 →