获取一场板球比赛中击球手对阵投球手的对位数据卡片。

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

获取单场板球比赛的击球手对阵投球手对位数据卡片。唯一输入是必填的数字型路径参数 matchId,可取自比赛列表、赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段,默认值为 151543。目前提供的探测记录中没有观察到该接口的实际响应,因此下文字段来自一份被截断且未经验证的源示例,仅作示意说明,不构成已验证的接口约定。示例返回一个 cards 数组,每张卡片包含 cardHeading(例如场地、对手球队或球员对位的标题)、cardLabel(赛制标签,例如 ODIs)、cardType(playerStatsCard)、playerOneImageId、playerTwoImageId 以及 subCard 数组。每个 subCard 条目带有点名球员的 subCardHeading,以及由 label 和 value 组成的 stats 数组,所有 value 均以字符串形式返回。场地卡片和对手卡片中示例出现的统计标签包括 Matches、Innings、Runs、Highest、Average、100s、50s、0s、Wickets、Best figures、Economy、Strike-rate 和 4-fers;球员对位卡片则包含 Runs scored、Balls faced 和 Dismissals。示例在最后一张卡片中间被截断,因此其他字段没有文档说明。这些卡片只是限定在本场比赛范围内的研究参考,并不是完整的历史交锋记录,也不是预测结果或梦幻积分总数,能否返回数据取决于所选比赛的覆盖情况。

API 功能

限定单场比赛的对位卡片 cards 数组带有 cardHeading、cardLabel 和 cardType,客户端只需传入一个 matchId,就能为每个对位主题渲染一个面板,不必再拼接多个统计接口的结果。
场地与对手球队记录 示例中既有球员在本场比赛场地上的表现卡片,也有球员对阵对手球队的卡片,每张卡片带有 Matches、Innings、Runs、Highest、Average 等统计项,方便赛前快速比较。
击球与投球两套统计项 每个 subCard 都带有由 label 和 value 组成的 stats 列表,击球一侧有 100s、50s 等数据,投球一侧有 Wickets、Economy、Strike-rate、Best figures 和 4-fers。
球员一对一对位卡片 专门的对位卡片把两名球员配成一组,列出 Innings、Runs scored、Balls faced 和 Dismissals 等标签,为某一组击球手与投球手的交锋提供紧凑的视图。
双方球员的图片 ID 每张卡片都返回 playerOneImageId 和 playerTwoImageId,界面可据此请求头像,并在统计列上方绘制双人头部区域。

在线 API 演示

GET /api/project/cricbuzz-cricket/fantasy-get-matchups

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

matchId 应该传什么?

使用比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段。它是必填的数字型路径参数,默认值为 151543。

响应里包含哪些内容?

源示例展示了一个 cards 数组。每张卡片包含标题、赛制标签、卡片类型、两个球员图片 ID,以及由球员组成的 subCard 列表,每名球员带有一组 label 和 value 构成的 stats 数组。示例被截断,除此之外的字段都应视为没有文档说明。

这些字段是在探测中观察到的吗?

不是。提供的探测记录中没有观察到该接口的响应,这些字段来自一份被截断的源示例,只是示意说明,并非已验证的接口约定。请在依赖前用自己的请求确认实际返回结构。

这是完整的历史交锋记录吗?

不是。该接口定位为单场比赛的击球手对阵投球手对位数据,示例卡片限定在某个场地、某支对手球队或某一组球员对位,请把它们当作本场比赛的研究参考,不要当作完整的职业生涯对比来展示。

统计值是数字吗?

示例中所有 value 都是字符串,有些还带有后缀,例如 Highest 最高分后面的星号。请以稳妥的方式解析数值,并保留原始文本用于展示。

会返回梦幻积分、赔率或预测吗?

示例中没有这类字段。卡片里只有偏历史数据的统计标签,所以不要把输出描述成积分预测、博彩赔率或保证的比赛结果。

如果某场比赛没有对位数据会怎样?

文档没有说明没有覆盖的比赛如何表示。请让客户端能处理 cards 为空数组或响应为空的情况,并显示中性的无数据提示。

相关接口

相关指南

查看订阅方案 →