按赛事 ID 查询板球系列赛的近期与即将进行的比赛

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

根据必填的数字路径参数 seriesId(取自系列赛列表或历史系列赛列表接口返回的 id 值)返回某一板球系列赛的赛程。来源响应示例包含 appIndex 区块(seoTitle、webURL)和 matchDetails 数组;matchDetailsMap 中的每一项带有日期区间键、比赛列表以及 seriesId。每场比赛都包含 matchInfo(matchId、matchDesc、matchFormat、state、status,以毫秒时间戳字符串表示的 startDate 和 endDate,currBatTeamId、isTimeAnnounced,带有 teamId、teamName、teamSName 和 imageId 的 team1 与 team2,以及包含 ground、city 和 timezone 的 venueInfo),另有 matchScore 对象,按球队和局次给出得分、出局数、回合数和宣布结束标记。赛程之间可能夹杂广告占位项(含 layout、name 和 position 的 adDetail),解析时应跳过。这些字段来自来源示例而非实际探测,因此 matchScore 等可选区块是否出现取决于赛事覆盖情况。

API 功能

按系列赛划分的赛程列表 传入一个 seriesId 即可获得单个锦标赛或巡回赛的近期与即将进行的比赛,赛事专题页无需再做全局比赛搜索。
日期区间分组键 赛程放在 matchDetailsMap 分组中,分组键是可直接阅读的日期区间标签(例如一场多日 Test 比赛的起止日期),可直接作为赛程小标题。
比赛标识与赛制字段 每个 matchInfo 都包含 matchId、matchDesc、matchFormat、state 以及状态描述语句,为每场比赛提供稳定的主键和展示标签。
每场比赛附带球队与场地 team1 和 team2 对象提供 teamId、teamName、teamSName 和 imageId,venueInfo 则补充球场、城市以及 UTC 偏移形式的时区。
分局比分摘要 matchScore 对象按局次给出双方的得分、出局数、回合数和宣布结束标记,足以在列表页拼出一行赛果。
需要过滤的广告占位项 含有 adDetail 而不含 matchDetailsMap 的条目只是版面占位,客户端通过判断存在哪个键即可将其跳过。

在线 API 演示

GET /api/project/cricbuzz-cricket/series-get-matches

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

这个接口需要的 seriesId 从哪里获取?

使用系列赛列表或历史系列赛列表接口返回的 id 字段。默认值 3641 是一个示例 id,来源响应示例把它对应到 2022 年新西兰英格兰之行。

它会同时返回已结束和未开始的比赛吗?

接口的定位是返回系列赛的近期与即将进行的比赛。不过来源示例只展示了已结束的比赛,带有状态描述和各局比分,这里也没有实际探测记录,因此对于未开始的比赛,state 和 status 会有所不同,matchScore 等比分区块可能不完整甚至缺失。

startDate 和 endDate 是什么格式?

在来源示例中它们是以字符串形式序列化的毫秒时间戳。请在客户端自行转换;需要显示当地比赛时间时,使用 venueInfo.timezone(例如 +01:00 这样的 UTC 偏移)。

matchDetails 里的 adDetail 条目是什么?

它们是带有 layout、name 和 position 字段的版面占位项,并不是比赛。构建赛程列表时,请跳过没有 matchDetailsMap 的数组元素。

能从这个接口拿到完整记分卡或文字解说吗?

不能。它只提供赛程列表和摘要比分。需要击球卡、投球数据或逐球文字时,请把 matchId 传给本产品的比赛记分卡或解说接口。

某个系列赛没有返回任何比赛时该怎么处理?

覆盖范围取决于具体赛事,所以应把空的或缺失的 matchDetails 数组以及任何非 200 响应当作正常的空状态处理,而不是自动换一个 seriesId 重试。

相关接口

相关指南

查看订阅方案 →