按 matchId 获取单场板球比赛的概览信息,包括系列赛、双方球队、场地、裁判、起止时间、状态与赛果文字。

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

通过必填的数字型 `matchId` 路径参数(默认值 41881)返回某一场板球比赛的概览信息。matchId 可从比赛、赛程、系列赛、球队或场地的列表类接口中获得。该接口目前没有记录到探测调用,下文字段来自源响应示例,尚未经过实际验证。示例是一场已结束的 U19 ODI 小组赛,响应包含:系列赛字段(seriesid、seriesname、seriestype、seriesstartdt、seriesenddt);比赛字段(matchid、matchdesc、matchformat、matchtype、startdate、enddate);状态字段(state、status、shortstatus、hidescorestatus);`team1` 和 `team2` 对象;`referee`;`umpire1` 至 `umpire3`;`venueinfo` 对象(ground、city、country、ends、established、hometeam);以及 isfantasyenabled、islivestreamenabled 等布尔标志。时间戳为毫秒级纪元时间,部分文本字段是空字符串。示例中的字段名为小写,请以真实响应为准确认键名的大小写。该接口返回的是比赛概览,而不是计分卡或解说内容。

API 功能

一次请求获得比赛概览 只需一个 matchId 就能拿到比赛的头部信息,适合从列表点进详情页时使用,不必先拉取完整计分卡。
系列赛与赛制背景 系列赛 ID 与名称、比赛描述、赛制(如 ODI)和比赛类型,帮助界面判断这场比赛属于哪项赛事、哪一级别的板球。
裁判与球审记录 示例中包含比赛裁判和最多三位场上球审,每人都有 ID、姓名和国家代码,可直接用于官员信息面板。
内嵌场地资料 venueinfo 带有球场名称、城市、国家、两端名称、主队和建成年份,场地信息随比赛一并返回,无需另外请求场地接口。
赛果与功能开关标志 state、status 和 shortstatus 文字旁边,还有梦幻板球、直播、投票等布尔标志,方便你决定为这场比赛展示哪些模块。

在线 API 演示

GET /api/project/cricbuzz-cricket/match-details-get-info

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

这个接口需要的 matchId 从哪里获取?

使用比赛列表、赛程、系列赛比赛、球队赛程或赛果,以及场地比赛接口返回的 matchId 值。默认值 41881 是一场已结束比赛的示例标识符。

这个接口会返回计分卡或解说吗?

不会。它返回的是球队、系列赛、场地、官员和状态文字等概览信息。各局比分、逐球数据和解说需要通过其他比赛详情类接口获取。

为什么有些字段是空值或 0?

在源示例中,抛币状态、球场容量和图片 ID 等值是空字符串或 0。不同比赛的数据覆盖程度不同,请把空白或零值视为暂无数据,而不是真实数值。

开始和结束时间是什么格式?

在源示例中,startdate 和 enddate 是毫秒级纪元时间戳数字。这一点尚未经过探测调用确认,请在自己的代码中转换,并对照一次真实响应进行核实。

响应中的键名是小写还是驼峰?

源示例使用 matchid、venueinfo 这样的小写键名,而其他接口则使用驼峰命名。由于没有探测记录,请以宽松的方式解析键名,并在真实响应中确认大小写。

相关接口

相关指南

查看订阅方案 →