获取近期已结束的板球比赛列表,按赛事类型分组,包含结果文字、系列赛背景、球队、场地和各局比分。

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

以一个 JSON 对象返回近期比赛数据。该接口在本页没有输入参数,直接向 /matches/v1/recent 发起 GET 请求即可。源接口说明还提到了可选的国家代码和 UTC 偏移请求头,但此处并未开放。该接口没有记录过探测调用,因此下文字段来自一份源示例,属于示意性的文档说明,并非已验证的接口约定。示例中的 200 响应包含:typeMatches,一个分组数组,每组带有 matchType 标签和 seriesMatches 数组;filters.matchType,列出 International、League、Domestic 和 Women 这几个标签;appIndex,带有 seoTitle 和 webURL 文本的对象;以及 responseLastUpdated,一个字符串。seriesMatches 的每个条目都包含一个 seriesAdWrapper,里面有 seriesId、seriesName 和 matches 数组,每场比赛都有 matchInfo 对象和 matchScore 对象。示例中的 matchInfo 包含 matchId、seriesId、seriesName、matchDesc(例如奖牌争夺战或半决赛)、matchFormat(示例中为 T20)、取值为 Complete 的 state、类似获胜方简称的 stateTitle、说明结果差距的 status 句子、hideScoreStatus、以毫秒时间戳字符串表示的 startDate 和 endDate、seriesStartDt 和 seriesEndDt、isTimeAnnounced、currBatTeamId、可选的 isFantasyEnabled 标志、team1 和 team2(teamId、teamName、teamSName、imageId),以及 venueInfo(id、ground、city、timezone、latitude、longitude)。matchScore 包含 team1Score 和 team2Score,每个里面是一个 inngs1 对象,带有 inningsId、runs、wickets 和 overs。该接口列出的是刚刚结束的比赛;至于能追溯到多久以前,文档没有说明,所以不要把它当作完整的历史档案。在依赖这些字段之前,请用自己的请求确认实际返回的结构和可选字段。

API 功能

已结束比赛的结果文字 示例中,state 为 Complete 的比赛同时带有获胜方标签 stateTitle 和说明差距的 status 句子,赛果列表无需额外请求就能展示比赛结果。
最终各局总分 示例中的 matchScore 给出双方 inngs1 的 runs、wickets 和 overs,足够在每条赛果下渲染一行最终比分。
赛事阶段标签 matchDesc 和 seriesName 能把每条赛果放到所属赛事的具体阶段,例如半决赛或奖牌争夺战,seriesStartDt 和 seriesEndDt 则标出赛事的举办时段。
球队与球场引用 team1 和 team2 提供 teamId、简称和 imageId,venueInfo 则补充球场、城市、场地 id 和时区偏移,便于把赛果链接到球队页和场地页。
从赛果跳转记分卡 每场近期比赛都带有 matchId,用户选中某条赛果后,它就是打开详细记分卡或比赛页面所用的键。

在线 API 演示

GET /api/project/cricbuzz-cricket/matches-recent

无需参数,点击查询即可调用 API。

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

近期比赛的响应是经过探测验证的吗?

没有。该接口没有记录过探测调用,字段列表来自一份源示例。其结构与实时比赛列表一致,但可选字段请在自己的响应中确认。

这个接口需要传入参数吗?

不需要。本页没有输入参数,直接向 /matches/v1/recent 发起 GET 请求即可。源接口说明提到了可选的国家代码和 UTC 偏移请求头,但这里无法配置。

怎样看出一场近期比赛是谁赢了?

使用 matchInfo 中的 status 句子和 stateTitle 标签。示例里获胜方和差距都是自由文本,没有单独的获胜方 id 字段,所以请谨慎解析文本,或者打开记分卡获取结构化的详情。

近期比赛能追溯到多久以前?

时间窗口没有文档说明。请用这个接口捕捉最近刚结束的比赛,不要假设它涵盖完整历史或所有赛事。

它与实时比赛接口有什么区别?

示例中列出的是状态为 Complete 的比赛,带有结果句子和最终各局比分。实时比赛接口列出的则是正在进行、处于掷币、休息或收工阶段的比赛,所以比赛进行中的视图请使用实时接口。

日期字段是什么样的?

示例中的 startDate、endDate、seriesStartDt 和 seriesEndDt 都是以字符串形式返回的毫秒时间戳。请先解析成数字,如果需要场地所在地的本地偏移,可以使用 venueInfo.timezone。

某个分组或字段可能缺失吗?

会。示例中的 isFantasyEnabled 等可选字段只出现在部分比赛里,而且根据覆盖范围,某个分组或系列赛也可能为空,所以每次取值都要做防御处理,并能应对空的 typeMatches 数组。

相关接口

相关指南

查看订阅方案 →