按球场 ID 查询该板球球场的预定比赛,按系列赛分组返回对阵双方、赛制、时间与状态

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

返回某一座板球球场的预定比赛。唯一必填的路径参数是 venueId,即数字类型的球场 ID,取自系列赛球场接口返回的 id 字段,默认示例值为 45。根据源响应示例,返回内容的顶层是 matchDetails 数组,其条目带有 matchDetailsMap,其中的键是系列赛名称(例如某项国内一日赛杯赛),match 数组则由 matchInfo 对象组成;此外还有包含 seoTitle 和 webURL 的 appIndex 对象。每个 matchInfo 包括 matchId、matchDesc、matchFormat、state、status、hideScoreStatus、isTimeAnnounced,以毫秒时间戳字符串表示的 startDate 与 endDate,seriesId、seriesName、seriesStartDt、seriesEndDt,含 teamId、teamName、teamSName 和 imageId 的 team1 与 team2,以及含 id、ground、city 和 timezone 的 venueInfo。本接口没有记录过实时探测,上述字段均来自未经验证的源示例,而且示例内容被截断。它覆盖的是预定赛程,并不是该球场过往赛果的完整档案;没有预定比赛的球场可能返回空内容。

API 功能

按球场筛选好的赛程 传入一个数字类型的 venueId,就能得到在该球场预定进行的比赛,球场页无需在客户端从全局赛程里自行筛选。
比赛按系列赛名称分组 matchDetails 的每个条目都带有 matchDetailsMap,其键是系列赛名称,match 数组列出该系列赛在此球场的比赛,适合按系列赛分段展示的版式。
毫秒时间戳表示的开始与结束时间 startDate 和 endDate 是毫秒时间戳字符串,配合球场时区偏移,无需解析展示文本就能算出当地时间和 UTC 开赛时间。
球队 ID 与简称 team1 和 team2 各自提供 teamId、teamName、teamSName 和 imageId,赛程行可以链接到球队页面,并显示简洁的队徽标识。
状态文字与比赛标识 每场比赛都包含 matchId、matchDesc、matchFormat、state,以及类似开赛提示的 status 字符串,提供构建可继续跳转的赛程列表所需的键和标签。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

venues-get-matches 接口会返回什么内容?

返回 venueId 所指球场的预定比赛。源示例显示有一个 matchDetails 数组,每个条目带有 matchDetailsMap,其中包含系列赛键和由 matchInfo 对象组成的 match 数组,另外还有一个 appIndex 对象。

有效的 venueId 从哪里获取?

使用系列赛球场接口返回的球场 id 字段。预填的 45 只是取自源文档的默认示例值,此处并未通过实时调用确认。

这里包含该球场的历史赛果吗?

按文档说明,它返回的是按球场查询的预定比赛,源示例也只显示即将进行的比赛。请不要把它当作该球场已进行比赛的完整历史记录。

startDate 和 endDate 应该怎样解读?

在源示例中,它们是以字符串形式给出的毫秒时间戳。构建日期之前先把它们转换成数字,并使用 venueInfo 的时区偏移来显示当地时间。

如果没有预定比赛会怎样?

覆盖范围取决于各球场可获得的数据,因此没有预定比赛的球场可能返回空的或缺失的 matchDetails 部分。请在界面中处理这种情况,不要假设列表一定有内容。

这个响应是否经过实时调用验证?

没有。该操作没有记录过探测调用。列出的字段来自被截断的源示例,所以在上线之前,请先用你自己的请求确认响应结构。

相关接口

相关指南

查看订阅方案 →