获取即将开赛的板球赛程列表,按赛事类型分组,包含比赛 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 搭建下一场比赛面板,并用 matchId 把用户选中的比赛带入比赛信息或研究视图。
- 先建立一份即将开赛的本地关注列表,同时实际验证国家和时区的处理方式,而不是预设时区或日期窗口的约定。
- 转换 startDate 毫秒时间戳字符串来显示倒计时,并用 isTimeAnnounced 标出尚未确认的时间。
- 按 seriesId 和 matchFormat 对即将开赛的比赛分组,为每个赛事规划通知推送的时间表。
- 用 venueInfo.timezone 把开赛时间换算成球场当地时间,用于球迷出行或观赛聚会策划类应用。
常见问题
即将开赛比赛的响应是经过探测验证的吗?
没有。该接口没有记录过探测调用,字段列表来自一份源示例。在依赖它之前,请在自己的响应中确认实际结构和可选字段。
这个接口需要传入参数吗?
不需要。本页没有输入参数,直接向 /matches/v1/upcoming 发起 GET 请求即可。源接口说明提到了可选的国家代码和 UTC 偏移请求头,但这里无法配置,所以不能选择日期范围或时区。
为什么即将开赛的比赛没有比分?
示例中的比赛处于 Preview 状态,没有 matchScore 对象。比分只会出现在已经开始的比赛上,这类比赛请使用实时或近期比赛接口。
应该使用哪个开赛时间字段?
排序和倒计时逻辑请使用毫秒时间戳字符串 startDate。status 和 hideScoreStatus 是展示用的文字,在示例中是 GMT 时间,因此不要去解析它们。
赛程能提前多久?
时间窗口没有文档说明。请把这份列表当作数据源提供的接下来一批比赛,而不是完整的赛季日历,也不是所有赛事的完整清单。
怎样获取我选中的某场比赛的详情?
读取 matchInfo.matchId;如果需要赛事背景,再取 seriesId 和 teamId。它们都是数字型标识,可以在其他比赛、系列赛和球队相关的请求中使用。
如果 isTimeAnnounced 是 false 怎么办?
示例中每场比赛的值都是 true。如果你遇到 false,请把 startDate 视为暂定时间,不要当作确定的开赛时间展示,因为文档没有描述这种情况。