按 matchId 和局数 iid 获取某一局的逐球图表数据,包括回合数、得分、出局与四六分事件、击球手和投球手 ID 及时间戳。

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

返回某场板球比赛中指定一局的逐球图表数据。必填的数字型 `matchId` 路径参数用于选择比赛(默认值 41881),可选的数字型 `iid` 查询参数用于选择局数(例如 1,默认值为 1)。该接口目前没有记录到探测调用,下文字段来自源响应示例,尚未经过实际验证。示例是一个带有 `balls` 数组的对象,每次投球对应一个条目,包含:ballLabel(简短标签,如得分数、表示出局的 W,或表示无得分球的圆点)、ballNbr、overNum(例如 49.6)、inningsId、totalRuns、event(已见的取值有 NONE、WICKET、FOUR 和 SIX,有时会与换 over 标记组合成以逗号分隔的字符串)、batsmanStrikerId、bowlerStrikerId,以及毫秒级纪元时间戳。示例中最新的一球排在最前面。返回内容是只带球员 ID 的精简投球记录,因此它不是解说数据,也不是完整的事件流水;在基于它绘制图表之前,请先核实实际的数据结构。

API 功能

按局划分的投球列表 通过 iid 查询参数指定某一局,同一个 matchId 可以逐局各查询一次,得到该局内每一次投球的记录。
逐球事件标记 event 字段会标出出局(WICKET)、四分球(FOUR)、六分球(SIX)等投球,每个 over 的最后一球还带有换 over 标记,便于直接生成高光标注。
适合绘图的球标签 ballLabel 用简短符号表示每次投球(得分数、出局用 W、无得分球用圆点),并附带 totalRuns,无需额外解析就能画出得分时间线。
击球手与投球手 ID batsmanStrikerId 和 bowlerStrikerId 以 ID 引用球员,可与球员或计分卡数据关联,构建击球手和投球手视图。
顺序与时间标记 ballNbr、overNum 和毫秒级时间戳让每一球都有明确的先后次序和发生时间,支持节奏与逐回合分析。

在线 API 演示

GET /api/project/cricbuzz-cricket/match-details-get-balls-graph

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

iid 参数是什么意思?

iid 是局数 ID,例如 1 代表第一局。它是可选参数,默认值为 1。换用其他 iid 再调用一次,即可获得同一场比赛另一局的数据。

这是解说文字吗?

不是。源示例中只有带 ID、标签、得分和时间戳的精简投球记录,没有解说文字,也没有球员姓名。球员 ID 需要通过其他球员或计分卡接口来解析。

投球记录按什么顺序返回?

在源示例中,最新的一球排在最前面,ballNbr 从 300 倒序递减。这一点尚未经过探测调用确认,如果顺序对你很重要,请在自己的代码中按 ballNbr 或 overNum 排序。

event 字段可能出现哪些值?

示例中出现了 NONE、WICKET、FOUR 和 SIX,以及可与其他值用逗号连接的换 over 标记。请把取值范围视为开放的,并妥善处理未知值。

响应可能为空吗?

可能。逐球数据取决于数据覆盖情况,没有逐球数据的比赛,或没有进行过的某一局,都可能不返回任何投球记录。绘图之前请先检查 balls 数组是否存在且包含条目。

相关接口

相关指南

查看订阅方案 →