按比赛、局和时间戳获取板球单个回合的详情

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

返回一场板球比赛中某一个回合(over)的详情。三个输入都是必填项:路径参数 `matchId`(默认 41881,可从比赛列表、赛程、系列赛、球队和场馆比赛等接口获取)、查询参数 `iid`(局编号,默认 1),以及查询参数 `tms`(用于标识该回合的毫秒级 epoch 时间戳,默认 1640424493537)。`tms` 请取自同一场比赛的逐回合摘要接口所返回的 `timestamp` 字段;该接口没有回合序号参数。目录将此接口描述为单个回合的逐球解说。该接口没有留存探测调用记录,下列字段来自源响应示例,该示例被截断且未经验证。示例是一个 JSON 对象,其中的 `overs` 列表每一行包含 batteamid、inningsid、osummary(球结果文本,例如 '0 0 W W ')、overnum(例如 14.4 或 49.6)、runs、score、wickets、wicketover、runrate、requiredrunrate 和 timestamp。各行顺序从第 2 局最新的回合一直排到第 1 局,默认的 tms 等于第 1 局中 overnum 为 49.6 的那一行的 timestamp。因此示例展示的是回合摘要行,而不是解说文字,目录的描述与示例并不一致;在依赖任何一种结构之前,请先查看真实响应。

API 功能

三个必填输入锁定一个回合 matchId、iid 和 tms 都是必填项,并附带默认值(41881、1 和 1640424493537),因此接口锁定的是某一局中的某一个回合,可以直接拿来试用。
时间戳直接取自回合列表 tms 就是逐回合摘要中的毫秒级 epoch 时间戳,这样下钻请求对应的是用户刚刚看到的那一行,而不是凭空猜的回合序号。
每个回合的球结果字符串 示例中的 osummary 是类似 '0 0 W W ' 的文本,每个球或附加球对应一个标记,可以为所选回合画出一条逐球结果条。
本回合得分、出局与累计比分 示例中每一行用 runs 和 wicketover 表示该回合自身的得分与出局,score 和 wickets 看起来是累计的局总分,卡片据此就能说明这一回合产生了什么。
跑分率与所需跑分率 示例中的 runrate 和 requiredrunrate 都是数值字段,第一局的 requiredrunrate 显示为 0,可以用来在第二局展示追分压力指示。
先列表再打开的两步流程 与逐回合摘要接口配合使用,就是一条简单的流程:先列出某一局的回合,再用所选回合自己的时间戳打开它的详情。

在线 API 演示

GET /api/project/cricbuzz-cricket/match-details-get-over-details

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-over-details?key=<API_KEY>&matchId=41881&iid=1&tms=1640424493537'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

这个接口对单个回合返回什么?

目录将其描述为单个回合的逐球解说。被截断的源示例却显示了 overs 列表,其中是带有 osummary、overnum、runs、score、wickets、wicketover、runrate、requiredrunrate 和 timestamp 的摘要行。在基于任何一种描述开发之前,请用你的 matchId 核实真实结构。

tms 值从哪里获取?

从同一场比赛的逐回合摘要接口中,取出你要查看的那个回合的 timestamp 字段,把它作为 tms 发送,并用相同的局编号作为 iid。来自其他比赛的 tms 无法在本场比赛中标识一个回合。

有回合序号参数吗?

没有。文档中的输入只有 matchId、iid 和 tms。回合由它的时间戳标识,所以请保留摘要行的时间戳,而不要根据回合序号自行推算。

它会返回逐球解说文字吗?

目录是这么说的,但源示例并没有展示解说文字,展示的是回合摘要行。请把解说字段视为未确认;如果需要经过验证的解说内容,请使用比赛详情分组中的解说类接口。

响应经过探测调用验证了吗?

没有。该接口没有留存探测调用记录,字段名、大小写和取值类型都只来自一份被截断的源示例。在依赖这些字段之前,请用真实响应核对。

osummary 里的标记是什么意思?

示例中出现了数字、W、Wd、N 和 B4,并以空格分隔,例如 '0 N 0 0 2 Wd W 0'。数字和 W 看起来分别表示跑分和出局,但 Wd、N 和 B4 的含义文档中没有说明,因此对非数字标记要谨慎映射。

这些默认值有什么用?

matchId 41881、iid 1 和 tms 1640424493537 是相互匹配的示例值:示例中该 tms 等于第 1 局 overnum 为 49.6 那一行的 timestamp。对其他比赛,请使用取自该场比赛回合摘要的 tms。

相关接口

相关指南

查看订阅方案 →