获取一场板球比赛中击球手对阵投球手的对位数据卡片。
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 为分析师搭建单场比赛的击球手对投球手对比工作表,每个 cardHeading 对应一张表,每名球员占一列。
- 在球员资料页旁加入对位面板,同时明确这只是本场比赛范围内的数据,不代表完整的历史交锋记录。
- 在梦幻板球研究应用中制作赛前关键对决轮播,遍历 cards,并展示每个 subCardHeading 及其 stats 列表。
- 为即将开打的比赛撰写前瞻文章时,提取文中提到球员的场地与对手统计卡片作为素材笔记。
- 在数据分析笔记本中,把 label 和 value 展开为以 matchId、卡片标题和球员为键的行,对比击球手的 Average 与投球手的 Economy。
常见问题
matchId 应该传什么?
使用比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段。它是必填的数字型路径参数,默认值为 151543。
响应里包含哪些内容?
源示例展示了一个 cards 数组。每张卡片包含标题、赛制标签、卡片类型、两个球员图片 ID,以及由球员组成的 subCard 列表,每名球员带有一组 label 和 value 构成的 stats 数组。示例被截断,除此之外的字段都应视为没有文档说明。
这些字段是在探测中观察到的吗?
不是。提供的探测记录中没有观察到该接口的响应,这些字段来自一份被截断的源示例,只是示意说明,并非已验证的接口约定。请在依赖前用自己的请求确认实际返回结构。
这是完整的历史交锋记录吗?
不是。该接口定位为单场比赛的击球手对阵投球手对位数据,示例卡片限定在某个场地、某支对手球队或某一组球员对位,请把它们当作本场比赛的研究参考,不要当作完整的职业生涯对比来展示。
统计值是数字吗?
示例中所有 value 都是字符串,有些还带有后缀,例如 Highest 最高分后面的星号。请以稳妥的方式解析数值,并保留原始文本用于展示。
会返回梦幻积分、赔率或预测吗?
示例中没有这类字段。卡片里只有偏历史数据的统计标签,所以不要把输出描述成积分预测、博彩赔率或保证的比赛结果。
如果某场比赛没有对位数据会怎样?
文档没有说明没有覆盖的比赛如何表示。请让客户端能处理 cards 为空数组或响应为空的情况,并显示中性的无数据提示。