获取一场板球比赛的场地与球场研究:球场信息、球场分析、预期总分、局均得分以及快投对旋转投球卡片。
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在比赛的梦幻研究页面中加入可用的场地与球场背景信息。
- 接口返回 204 时显示明确的无覆盖提示,并仅把一般场地信息作为单独标注的资源,而不是等同的球场分析。
- 制作掷币决策解读:把同一份响应中的预期总分与第一局、第二局平均得分放在一起对照。
- 把 recentMatches 各行中的比赛 ID 链接到你自己的记分卡页面,让读者可以打开此前在该场地进行的比赛。
- 在分析笔记本中对比快投与旋转投球的经济率、击球率和无得分球百分比,再撰写赛前的投球阵容分析。
常见问题
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 当作标识串使用。
这些数字是数值还是字符串?
示例中的平均得分、统计值和比分全部是字符串,比分采用“得分-出局数”的文本形式。请在自己的代码中解析,并保留原始文本用于展示。
这是保证准确的球场报告或预测吗?
不是。球场分析和预期总分只是针对一场比赛的编辑性研究参考,并不承诺球场实际表现,响应中也没有梦幻积分或博彩赔率。示例本身还带有一段说明性的免责文字。