按比赛 ID 获取板球每回合得分图表数据
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →根据必填的数字路径参数 `matchId`(默认 41881)返回一场板球比赛的每回合得分(runs-per-over)图表数据。matchId 可从比赛列表、赛程、系列赛、球队赛程与赛果以及场馆比赛等接口获取。该接口没有查询参数,因此无法按局数、回合区间或球队筛选,一次请求只对应一场比赛。该接口没有留存探测调用记录,源响应示例也只是一个空 JSON 对象(`{}`),所以这里没有任何已确认的响应字段:回合编号、得分合计、局标识和球队标识都未经验证。请把输出结构视为未验证,先用你关心的那场比赛取一份真实响应,再把它绑定到图表或表格。该数据定位为回合级汇总数据,与比赛详情分组中回合详情和解说接口提供的逐球数据是不同的视角。数据覆盖取决于赛事和比赛状态,对于尚无图表数据或从未生成过图表数据的比赛,返回空内容或内容极少都是合理的结果。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-overs-graph API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-overs-graph?key=<API_KEY>&matchId=41881'
查询结果
使用场景
- 在对照真实响应核对图表数据结构之后,为所选比赛提供每回合得分对比组件。
- 导出可用的回合级数据序列用于击球节奏分析,并与逐球解说数据区分开来。
- 在比赛中心页面的比分卡旁放置逐回合得分图表面板,待数据序列的结构确认后再接入。
- 在发布前做编辑检查,标出图表数据返回为空的比赛,避免发布一个没有内容可画的图表模块。
- 赛后报告模板需要逐回合可视化时,为已完赛的比赛预取图表数据。
常见问题
每回合得分图表接口返回什么内容?
按接口说明,它返回一场比赛的每回合得分图表数据。源响应示例只是一个空 JSON 对象,也没有留存探测调用记录,所以字段名、嵌套方式和对各局的处理方式都没有文档。请在构建功能之前先查看一份真实响应。
哪个参数是必填的,matchId 从哪里获取?
只有数字路径参数 matchId 是必填项(默认 41881)。可使用比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口返回的 matchId。
这个响应经过探测调用验证了吗?
没有。该接口没有留存探测调用记录,源示例是 `{}`。除请求形式之外的内容,在用真实比赛测试之前都属于未验证。
它与回合详情和解说接口有什么不同?
本接口面向汇总后的每回合得分图表数据。比赛详情分组中的回合详情和解说接口才是查找逐球信息的地方,所以不要期待在这里得到逐球记录。
可以按局数或回合区间筛选吗?
不可以。唯一的输入是 matchId,没有定义任何查询参数。如果响应中包含多个局,需要在你检查过真实数据后,自行在客户端完成选取。
每场比赛都会返回图表数据吗?
不一定。数据覆盖取决于赛事和比赛,对于未开始的比赛或没有图表数据的比赛,可能返回空内容或内容极少。请在界面中妥善处理这种情况,不要直接报错。