获取即将开赛的板球赛程列表,按赛事类型分组,包含比赛 ID、开赛时间、球队、场地、赛制和系列赛背景。

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

以一个 JSON 对象返回即将进行的比赛数据。该接口在本页没有输入参数,直接向 /matches/v1/upcoming 发起 GET 请求即可。源接口说明还提到了可选的国家代码和 UTC 偏移请求头,但此处并未开放,因此不应假设存在日期范围或时区方面的行为。该接口没有记录过探测调用,因此下文字段来自一份源示例,属于示意性的文档说明,并非已验证的接口约定。示例中的 200 响应包含:typeMatches,一个分组数组,每组带有 matchType 标签和 seriesMatches 数组;filters.matchType,列出 International、League、Domestic 和 Women;appIndex,带有 seoTitle 和 webURL 文本的对象;以及 responseLastUpdated,一个字符串。seriesMatches 的每个条目都包含一个 seriesAdWrapper,里面有 seriesId、seriesName 和 matches 数组,每场比赛都有 matchInfo 对象。示例中的 matchInfo 包含 matchId、seriesId、seriesName、matchDesc(例如 4th Match)、matchFormat(出现了 T20 和 ODI)、取值同为 Preview 的 state 和 stateTitle、一句 status 以及内容形如 GMT 开赛时间的 hideScoreStatus 字符串、以毫秒时间戳字符串表示的 startDate 和 endDate、seriesStartDt 和 seriesEndDt、isTimeAnnounced、team1 和 team2(teamId、teamName、teamSName、imageId),以及 venueInfo(id、ground、city、timezone、latitude、longitude)。由于这些比赛尚未开始,示例中的比赛不带 matchScore 对象。列表向未来延伸多少天,文档没有说明,所以不要假设存在固定的赛程窗口,也不要假设涵盖所有赛事。在依赖这些字段之前,请用自己的请求确认实际返回的结构和可选字段。

API 功能

预览状态的赛程 示例中的比赛 state 和 stateTitle 均为 Preview,在混合的赛事日历里,可以很容易把尚未开始的比赛与进行中或已结束的比赛区分开。
两种形式的开赛时间 每场比赛既有写在 status 和 hideScoreStatus 里的可读开赛语句(示例中以 GMT 表示),也有毫秒时间戳字符串形式的 startDate 和 endDate,可用于排序和倒计时。
时间是否确认的标志 isTimeAnnounced 说明一场比赛的开赛时间是否已经确认,赛程视图因此可以把暂定的时段标注出来,而不是当作确定时间展示。
场地时区偏移与坐标 venueInfo 包含 ground、city、时区偏移、latitude 和 longitude,可以按球场当地时间显示开赛时刻,也可以把球场标在地图上。
赛制与比赛场次标签 matchFormat(示例中出现 T20 和 ODI)、4th Match 这样的 matchDesc 以及 seriesName,让比赛卡片不需要再次查询就能一目了然。

在线 API 演示

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

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

即将开赛比赛的响应是经过探测验证的吗?

没有。该接口没有记录过探测调用,字段列表来自一份源示例。在依赖它之前,请在自己的响应中确认实际结构和可选字段。

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

不需要。本页没有输入参数,直接向 /matches/v1/upcoming 发起 GET 请求即可。源接口说明提到了可选的国家代码和 UTC 偏移请求头,但这里无法配置,所以不能选择日期范围或时区。

为什么即将开赛的比赛没有比分?

示例中的比赛处于 Preview 状态,没有 matchScore 对象。比分只会出现在已经开始的比赛上,这类比赛请使用实时或近期比赛接口。

应该使用哪个开赛时间字段?

排序和倒计时逻辑请使用毫秒时间戳字符串 startDate。status 和 hideScoreStatus 是展示用的文字,在示例中是 GMT 时间,因此不要去解析它们。

赛程能提前多久?

时间窗口没有文档说明。请把这份列表当作数据源提供的接下来一批比赛,而不是完整的赛季日历,也不是所有赛事的完整清单。

怎样获取我选中的某场比赛的详情?

读取 matchInfo.matchId;如果需要赛事背景,再取 seriesId 和 teamId。它们都是数字型标识,可以在其他比赛、系列赛和球队相关的请求中使用。

如果 isTimeAnnounced 是 false 怎么办?

示例中每场比赛的值都是 true。如果你遇到 false,请把 startDate 视为暂定时间,不要当作确定的开赛时间展示,因为文档没有描述这种情况。

相关接口

相关指南

查看订阅方案 →