获取一场板球比赛的场地与球场研究:球场信息、球场分析、预期总分、局均得分以及快投对旋转投球卡片。

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

从梦幻研究数据中获取单场板球比赛的场地与球场背景信息。唯一输入是必填的数字型路径参数 matchId,可取自比赛列表、赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段,默认值为 151543。接口说明指出,大多数没有梦幻覆盖的比赛会返回 HTTP 204,因此空结果属于正常情况,而不是错误。目前提供的探测记录中没有观察到该接口的实际响应,下文字段来自一份已覆盖比赛的源示例,仅作示意说明,不构成已验证的接口约定。示例 200 响应包含 groundName、city、country 和一个 id 值;groundDetails 与 pitchDetails 数组,由标题和正文成对组成(例如边界尺寸和一段球场分析文字);runsExpected,即标题加正文的一组数据,例如预期总分;averageScores 卡片,包含标题、说明统计了多少场比赛的标签,以及第一局和第二局平均得分的 values 列表;cards,即快投对旋转投球等统计卡片,带有 cardHeading、cardLabel、cardType 和 subCard 分组,每组由 label 与 value 组成(Matches、Wickets、Best figures、Economy、Strike-rate、Dot%);recentMatches 卡片,包含表头和数据行,每行有 followUpLinkText 标识串和一个 values 列表,列表以比赛 ID 开头,随后是球队标签和两局得分;以及 disclaimer 数组,用于放置说明性提示。示例中所有数字都以字符串形式返回。这些数据只是赛前研究参考,并不是对球场表现的保证,也不是梦幻积分总数或博彩赔率,能否返回数据取决于所选比赛的覆盖情况。

API 功能

球场与球场分析文字 同时返回 groundName、city、country,以及由标题和正文成对组成的 pitchDetails 与 groundDetails,比赛页可以展示比赛地点、边界尺寸和一段球场分析文字。
预期总分与局均得分 runsExpected 给出预期总分的说明,averageScores 卡片给出第一局和第二局的平均总分,并带有说明统计了多少场比赛的标签。
快投对旋转投球统计卡片 cards 数组里的统计卡片通过 subCard 分组,把快投和旋转投球分别列出 Matches、Wickets、Best figures、Economy、Strike-rate 和 Dot% 等标签,可以直接渲染成并排的两列。
本场地近期比赛记录 recentMatches 列出此前在该场地进行的比赛,每行带有标识串、开头的比赛 ID、球队标签和两局得分,可以把每一行链接回记分卡或比赛详情接口。
明确的无覆盖信号 没有梦幻覆盖的比赛会返回 204,而不是一份不完整的响应,客户端可以据此区分场地研究缺失与请求失败,并干净地隐藏该面板。

在线 API 演示

GET /api/project/cricbuzz-cricket/fantasy-get-venue-info

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

matchId 应该传什么?

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

响应里包含哪些内容?

源示例展示了 groundName、city、country、id,groundDetails 与 pitchDetails 文字组,runsExpected、averageScores,包含快投对旋转投球统计的 cards 数组,recentMatches 数据行以及 disclaimer 列表。这些内容来自未经验证的源示例,请用自己的请求确认实际返回结构。

为什么返回 204 且没有响应体?

接口说明指出,大多数没有梦幻覆盖的比赛会返回 204,该状态的源示例是一个空对象。请把它当作无数据状态,显示中性的提示,并且不要在短时间内反复重试。

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

不是。提供的探测记录中没有观察到该接口的响应,所以所有字段都来自一份已覆盖比赛的源示例,只是示意说明,并非已验证的接口约定。

如何解读 recentMatches 的数据行?

示例中表头列表有三项(Match、1st Innings、2nd Innings),而每一行的 values 列表有四项,依次是比赛 ID、球队标签和两局得分。请按位置稳妥地映射各列,并且只把 followUpLinkText 当作标识串使用。

这些数字是数值还是字符串?

示例中的平均得分、统计值和比分全部是字符串,比分采用“得分-出局数”的文本形式。请在自己的代码中解析,并保留原始文本用于展示。

这是保证准确的球场报告或预测吗?

不是。球场分析和预期总分只是针对一场比赛的编辑性研究参考,并不承诺球场实际表现,响应中也没有梦幻积分或博彩赔率。示例本身还带有一段说明性的免责文字。

相关接口

相关指南

查看订阅方案 →