按 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 用户点击某场赛程后,打开比赛详情页的头部,展示双方球队、系列赛名称、赛制和赛果文字。
- 在比赛资料卡片上显示裁判和三位球审的姓名及所属国家。
- 为你跟踪的每场比赛补全球场、城市、国家、两端名称和建成年份,丰富场地目录。
- 在渲染标签页之前,先检查 state 以及 isfantasyenabled、islivestreamenabled 等标志,决定这场比赛要显示哪些模块。
- 把已结束比赛的元数据(起止时间戳、系列赛 ID、比赛类型)按 matchid 归档到赛果数据库中。
常见问题
这个接口需要的 matchId 从哪里获取?
使用比赛列表、赛程、系列赛比赛、球队赛程或赛果,以及场地比赛接口返回的 matchId 值。默认值 41881 是一场已结束比赛的示例标识符。
这个接口会返回计分卡或解说吗?
不会。它返回的是球队、系列赛、场地、官员和状态文字等概览信息。各局比分、逐球数据和解说需要通过其他比赛详情类接口获取。
为什么有些字段是空值或 0?
在源示例中,抛币状态、球场容量和图片 ID 等值是空字符串或 0。不同比赛的数据覆盖程度不同,请把空白或零值视为暂无数据,而不是真实数值。
开始和结束时间是什么格式?
在源示例中,startdate 和 enddate 是毫秒级纪元时间戳数字。这一点尚未经过探测调用确认,请在自己的代码中转换,并对照一次真实响应进行核实。
响应中的键名是小写还是驼峰?
源示例使用 matchid、venueinfo 这样的小写键名,而其他接口则使用驼峰命名。由于没有探测记录,请以宽松的方式解析键名,并在真实响应中确认大小写。