获取正在进行的板球比赛列表,按赛事类型和系列赛分组,包含比赛 ID、球队、场地、状态文字和各局比分(如有)。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →以一个 JSON 对象返回当前的实时比赛数据。该接口在本页没有输入参数,直接向 /matches/v1/live 发起 GET 请求即可。源接口说明还提到了可选的国家代码和 UTC 偏移请求头,但此处并未开放,因此没有任何按地区或时区调整结果的文档说明。一次探测调用返回了 HTTP 200 和一个 JSON 对象,其中包含:typeMatches,一个分组数组,每组带有 matchType 标签(观察到 International、League、Domestic 和 Women)以及一个 seriesMatches 数组;filters.matchType,列出同样分组标签的数组;appIndex,带有 seoTitle 和 webURL 文本的对象;responseLastUpdated,一个字符串;以及 contentFilters,由 filterId 和 filterName 组成的数组(观察到 liveStream 过滤项)。seriesMatches 中的每个条目要么是 seriesAdWrapper,其中包含 seriesId、seriesName 和 matches 数组(部分包装对象还带有 isLiveStreamEnabled),要么是带有 name、layout 和 position 的占位广告对象,罗列比赛时应跳过后者。每场比赛都有 matchInfo 对象,且在探测到的大多数比赛中还带有 matchScore 对象。matchInfo 包含 matchId、seriesId、seriesName、matchDesc、matchFormat(例如 T20 或 TEST)、state 与 stateTitle(探测值包括 In Progress、Toss、Innings Break、Stumps、Badlight 和 Complete)、status、hideScoreStatus、以毫秒时间戳字符串表示的 startDate 和 endDate、isTimeAnnounced、team1 和 team2(teamId、teamName、teamSName、imageId),以及 venueInfo(id、ground、city、timezone、latitude、longitude);currBatTeamId、isFantasyEnabled 和 livestreamEnabled 只在部分比赛中出现。matchScore 包含 team1Score 和 team2Score,每个里面是 inngs1 之类的局对象,带有 inningsId、runs、wickets 和 overs。以上所有字段都见于探测样本或源示例;但样本只是某一时刻的快照,并非保证不变的接口约定,所以请把可选字段当作可能缺失来处理。返回结果反映请求时刻正在进行的比赛,因此列表可能很短甚至为空,接口也不承诺特定的延迟,或对所有赛事的覆盖。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/matches-live 无需参数,点击查询即可调用 API。
API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/matches-live?key=<API_KEY>'
查询结果
使用场景
- 基于 typeMatches 数组和 matchType 过滤项搭建实时比赛发现页,并把 appIndex 对象与比赛记录分开处理。
- 制作比分滚动条:读取每一局 matchScore 中的 runs、wickets 和 overs,在没有比分对象时退回显示 status 文字。
- 从实时比赛中收集 matchId,把用户选中的那场交给比赛中心、记分卡或文字解说类请求使用。
- 当 livestreamEnabled 和 isFantasyEnabled 标志存在时,在实时比赛卡片上加上直播或梦幻可选的徽标。
- 每次轮询都保存 responseLastUpdated 字符串,让看板能够显示实时快照已经过去了多久。
常见问题
实时比赛接口需要传入参数吗?
不需要。本页没有输入参数,直接向 /matches/v1/live 发起 GET 请求即可。源接口说明提到了可选的国家代码和 UTC 偏移请求头,但这里无法配置,所以不要假设会返回按地区或时区调整后的结果。
如何从实时比赛卡片跳转到某一场具体的比赛?
读取目标比赛的 matchInfo.matchId;如果还需要赛事信息,再取 seriesId。它们都是数字型标识,可以在其他比赛级别的请求中复用。
seriesMatches 里除了 matches 还有什么?
探测返回了两种条目:一种是带有 seriesId、seriesName 和 matches 的 seriesAdWrapper,另一种是带有 name、layout 和 position 的占位广告对象。渲染比赛列表时,请跳过没有 seriesAdWrapper 的条目。
为什么有些实时比赛没有 matchScore?
在探测样本中,大多数比赛带有 matchScore,但并非全部。请把 matchScore、currBatTeamId 和各个布尔标志当作可选字段,缺少比分对象时,退回使用 status 或 hideScoreStatus。
startDate 和 endDate 用的是什么时间格式?
它们是以字符串形式返回的毫秒时间戳,转换前请先解析成数字。venueInfo.timezone 给出场地所在地的 UTC 偏移(例如 +09:00),可以用来显示当地开赛时间。
responseLastUpdated 是什么意思?
它是本次快照的字符串时间标记。样本里看起来像以秒为单位的 Unix 时间戳,但其格式没有文档说明,所以在用它判断数据新鲜度之前,请先在自己的响应里确认。
这份列表保证完整或实时吗?
不保证。它只是请求时刻数据源列为进行中的比赛快照,可能很短甚至为空,也不一定包含所有赛事,同时不承诺任何特定延迟。