获取近期已结束的板球比赛列表,按赛事类型分组,包含结果文字、系列赛背景、球队、场地和各局比分。
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 做一个近期赛果回顾页,用户选中某场比赛时打开完整记分卡。
- 在一场比赛离开实时列表之后,仍能找到这场刚打完的比赛,同时不把该接口当作完整的历史档案。
- 按 seriesId 对近期比赛分组,生成赛事赛果表,并按 endDate 时间戳给条目排序。
- 生成赛后摘要,把每条 status 文字与球队简称和各局总分配在一起,用于邮件通讯或聊天机器人。
- 利用每条赛果附带的 venueInfo 中的 id、ground 和 city 字段,把已结束的比赛链接到球场页面。
常见问题
近期比赛的响应是经过探测验证的吗?
没有。该接口没有记录过探测调用,字段列表来自一份源示例。其结构与实时比赛列表一致,但可选字段请在自己的响应中确认。
这个接口需要传入参数吗?
不需要。本页没有输入参数,直接向 /matches/v1/recent 发起 GET 请求即可。源接口说明提到了可选的国家代码和 UTC 偏移请求头,但这里无法配置。
怎样看出一场近期比赛是谁赢了?
使用 matchInfo 中的 status 句子和 stateTitle 标签。示例里获胜方和差距都是自由文本,没有单独的获胜方 id 字段,所以请谨慎解析文本,或者打开记分卡获取结构化的详情。
近期比赛能追溯到多久以前?
时间窗口没有文档说明。请用这个接口捕捉最近刚结束的比赛,不要假设它涵盖完整历史或所有赛事。
它与实时比赛接口有什么区别?
示例中列出的是状态为 Complete 的比赛,带有结果句子和最终各局比分。实时比赛接口列出的则是正在进行、处于掷币、休息或收工阶段的比赛,所以比赛进行中的视图请使用实时接口。
日期字段是什么样的?
示例中的 startDate、endDate、seriesStartDt 和 seriesEndDt 都是以字符串形式返回的毫秒时间戳。请先解析成数字,如果需要场地所在地的本地偏移,可以使用 venueInfo.timezone。
某个分组或字段可能缺失吗?
会。示例中的 isFantasyEnabled 等可选字段只出现在部分比赛里,而且根据覆盖范围,某个分组或系列赛也可能为空,所以每次取值都要做防御处理,并能应对空的 typeMatches 数组。