通过备用信息路径,按比赛 ID 获取板球比赛概览信息
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回单场板球比赛的概览信息,由必填的数字型路径参数 `matchId` 指定(默认值 41881)。这是目录中的第二条比赛信息路径:目录说明其响应与 match-details/get-info 接口相同,并且这是移动应用实际调用的路径,因此可以在两条路径中任选其一,并让你的客户端统一使用它。matchId 可从比赛列表、赛程、系列赛、球队和场地的比赛接口中获得。本接口没有记录过实时调用,下列字段来自源响应示例,均未经验证。示例是一场已结束的 U19(19 岁以下)一日国际赛小组赛,响应包含系列赛字段(seriesid、seriesname、seriesstartdt、seriesenddt)、比赛字段(matchid、matchdesc、matchformat、matchtype、startdate、enddate、daynight)、状态与结果文本(state、status、shortstatus、hidescorestatus、tossstatus)、带 teamid、teamname 和 teamsname 的 `team1` 与 `team2` 对象、一个 `referee` 对象、带 id、name 和 country 的 `umpire1` 至 `umpire3` 对象、一个 `venueinfo` 对象(ground、city、country、ends、established、hometeam)、含页面标题和网页地址的 `appindex` 区块,以及 isfantasyenabled、islivestreamenabled 等布尔标记。示例中的时间戳是毫秒级 epoch 时间,tossstatus、statetitle、场地容量等若干文本字段为空字符串。示例使用的是小写字段名,所以请以真实响应核对键名的大小写。本接口返回的是比赛概览,不是记分卡,也不是文字解说数据流。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-info-alt API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-info-alt?key=<API_KEY>&matchId=41881'
查询结果
使用场景
- 在记分卡上方填充比赛背景页头,展示所选 matchId 对应的目录球队、场地、比赛官员和抛币文字。
- 让 SDK 或后端客户端统一使用两条等效比赛信息路径中的一条,并在集成阶段把本路径的输出与原路径对比一次,再放弃另一条。
- 在赛前预览中把抛币行放在球场名称旁边,当 tossstatus 为空字符串时隐藏抛币这一行。
- 打印比赛资料卡,列出系列赛名称、比赛描述、赛制、裁判以及三名场上裁判及其所属国家。
- 为已结束的比赛卡片标注结果:用 shortstatus 显示简短结果,用 status 显示较长语句,如示例中 AFGU19 获胜的那一行。
常见问题
它与 match-details/get-info 接口有什么区别?
目录说明两者的响应相同,并且这条备用路径正是移动应用所调用的路径。文档中唯一的差异是 URL 路径,所以请为客户端选定一条路径,避免对同一份概览发送两次请求。
需要哪些参数,从哪里获取?
只需要 URL 路径中的数字型 matchId。可从比赛列表、赛程、系列赛、球队赛程与结果,以及场地比赛接口中取得。默认值 41881 是一场已结束的 U19 一日国际赛小组赛的示例标识。
响应经过实时调用验证吗?
没有。本接口没有记录过实时调用,所以字段列表来自源响应示例。在依赖这些字段之前,请用你自己的 matchId 查看一次真实响应,核对字段名称、大小写和值类型。
抛币信息总是有值吗?
示例中没有。即使比赛已经结束,示例里的 tossstatus 也是空字符串。请把空字符串当作暂无数据,而不是抛币结果。
它包含各局比分或解说吗?
示例里只有 status、shortstatus 这类结果文本,没有各局比分对象、击球记录或解说条目。这些内容请使用记分卡、实时比分和文字解说接口。
开始与结束时间是什么格式?
示例中的 startdate 和 enddate 是看起来像毫秒级 epoch 的数字,例如 1640410200000。这一点没有经过实时调用确认,请在自己的代码中转换,并用真实响应核对。