按 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在比赛中心页面里,为某一局绘制逐球得分时间线或按 over 汇总的柱状图。
- 通过筛选每一球的 event 字段,在图表上标出出局、四分球和六分球的位置。
- 把某一局的投球数据导出到研究笔记本中,计算每个 over 的得分速率,不过需先核实实际响应的结构。
- 将 batsmanStrikerId 和 bowlerStrikerId 与球员数据关联,生成投球手的投球段或击球手对投球手的对阵视图。
- 对同一场比赛分别用 iid 为 1 和 2 各调用一次,比较两个局的进攻节奏。
常见问题
iid 参数是什么意思?
iid 是局数 ID,例如 1 代表第一局。它是可选参数,默认值为 1。换用其他 iid 再调用一次,即可获得同一场比赛另一局的数据。
这是解说文字吗?
不是。源示例中只有带 ID、标签、得分和时间戳的精简投球记录,没有解说文字,也没有球员姓名。球员 ID 需要通过其他球员或计分卡接口来解析。
投球记录按什么顺序返回?
在源示例中,最新的一球排在最前面,ballNbr 从 300 倒序递减。这一点尚未经过探测调用确认,如果顺序对你很重要,请在自己的代码中按 ballNbr 或 overNum 排序。
event 字段可能出现哪些值?
示例中出现了 NONE、WICKET、FOUR 和 SIX,以及可与其他值用逗号连接的换 over 标记。请把取值范围视为开放的,并妥善处理未知值。
响应可能为空吗?
可能。逐球数据取决于数据覆盖情况,没有逐球数据的比赛,或没有进行过的某一局,都可能不返回任何投球记录。绘图之前请先检查 balls 数组是否存在且包含条目。