按比赛、局和时间戳获取板球单个回合的详情
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 用户在比赛中心点击某一行回合摘要时,把它展开为该回合的文字详情。
- 下钻过程中始终保留比赛、局与已验证的 tms,而不是自行编造文档中没有的回合序号参数。
- 把 osummary 文本拆成标记,并为出局和边界球设置样式,为所选回合展示逐球结果条。
- 读取每一行的 wicketover,在某一局的时间线上标出出现出局的回合。
- 在开发解说功能之前,先做一次性的集成检查,把真实响应与目录中的逐球解说描述进行比对。
常见问题
这个接口对单个回合返回什么?
目录将其描述为单个回合的逐球解说。被截断的源示例却显示了 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。