按 live、recent 或 upcoming 三种状态获取板球比赛列表,返回系列赛、球队、场地、状态文字、各局比分和 matchId。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →通过必填的 `type` 路径参数选择比赛状态视图,可选值为 `live`(进行中)、`recent`(近期已结束,默认值)和 `upcoming`(即将开始),返回对应的板球比赛列表。该接口目前没有记录到探测调用,下文字段来自源响应示例,尚未经过实际验证。示例的顶层是 `typeMatches` 数组,按赛事类别(`matchType`,例如 International、League、Domestic 和 Women)分组,每组包含带有 `matches` 列表的 `seriesMatches`。每个条目都有 `matchInfo` 对象,包含 matchId、seriesId、seriesName、matchDesc、matchFormat、startDate、endDate、state、stateTitle、status、team1 和 team2(各含 teamId、teamName、teamSName),以及 venueInfo(ground、city、timezone);已经产生比分的比赛还会带有 `matchScore`,列出每个局的 runs、wickets 和 overs。日期是以毫秒为单位的纪元时间戳字符串。拿到列表后,可把返回的 matchId 传给比赛详情类接口继续查询。数据取决于当前的赛程,所以某个视图可能没有任何比赛。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/matches-list API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/matches-list?key=<API_KEY>&type=recent'
查询结果
使用场景
- 为应用首页的比分板提供数据,在实时标签页中显示每场比赛的状态文字和当前局比分。
- 用 recent 视图搭建赛果页面,按系列赛归类已结束的比赛,并展示 stateTitle 和比赛结果文字。
- 用 startDate、matchDesc 和场地信息填充即将开始的赛程日历,并把毫秒时间戳转换成读者所在时区的时间。
- 用同一个列表组件承载三个标签页,请求封装只改变 type 的值,同时为每个标签页准备各自的空状态提示。
- 在数据管道中收集列表里的 matchId 和 seriesId,作为后续查询计分卡和系列赛资料的种子。
常见问题
type 参数可以填哪些值?
文档记载的取值有 `live`、`recent` 和 `upcoming`,默认值为 `recent`。其他取值没有文档说明,建议先在自己的代码里校验后再发起请求。
某个视图会返回空的比赛列表吗?
会。结果取决于请求时刻实际存在的赛程,尤其是 live 视图,在没有比赛进行时可能为空。遇到空的或缺失的 typeMatches 数组时,请给出清晰的空状态提示。
怎样从这个列表进一步获取某场比赛的完整信息?
从 matchInfo 里取出 matchId,传给比赛详情类接口即可,例如用 match-details/get-info 获取比赛基本信息。这个列表只是摘要视图,并不是完整的计分卡。
日期和时间是什么格式?
在源示例中,startDate 和 endDate 是毫秒级纪元时间戳字符串,venueInfo 中带有类似 +09:00 的时区偏移。这一点尚未经过探测调用确认,依赖具体格式之前请先查看一次真实响应。
可以按国家或时区筛选吗?
不可以。该接口只开放 `type` 这一个路径参数。请在自己的代码中把时间戳转换成用户所在时区,并在拿到列表后再按系列赛或球队筛选。