按赛事 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 搭建赛事比赛中心,在日期区间小标题下列出某个系列赛的近期与即将进行的比赛。
- 把选中比赛的 matchId 传给下游页面打开比赛详情,而不是为每个赛事页都做一次全局比赛搜索。
- 制作双边巡回赛的赛程页,例如包含热身赛的 Test 系列赛,用 matchDesc 和 matchFormat 作为每一行的标签。
- 把已结束比赛的状态描述与 matchScore 中各局得分、出局数组合起来,渲染赛果摘要行。
- 利用 startDate、endDate 时间戳和场地时区偏移,把系列赛赛程同步到日历或提醒推送中。
常见问题
这个接口需要的 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 重试。