按球场 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 制作球场专属的赛程页,列出访客所选球场上的全部预定比赛。
- 帮助编辑团队规划某座球场的报道安排,拉取那里即将进行的比赛并按系列赛归类。
- 把 startDate 与返回的 venueInfo 时区偏移结合起来,为球场生成当地时间日历。
- 利用每一行的 matchId 和 seriesId,把球场赛程链接到对应的记分卡、解说或系列赛页面。
- 当赛程中出现赛制 matchFormat 不同的新比赛时,向关注某球场的新闻简报或购票规划工具发出提醒。
常见问题
venues-get-matches 接口会返回什么内容?
返回 venueId 所指球场的预定比赛。源示例显示有一个 matchDetails 数组,每个条目带有 matchDetailsMap,其中包含系列赛键和由 matchInfo 对象组成的 match 数组,另外还有一个 appIndex 对象。
有效的 venueId 从哪里获取?
使用系列赛球场接口返回的球场 id 字段。预填的 45 只是取自源文档的默认示例值,此处并未通过实时调用确认。
这里包含该球场的历史赛果吗?
按文档说明,它返回的是按球场查询的预定比赛,源示例也只显示即将进行的比赛。请不要把它当作该球场已进行比赛的完整历史记录。
startDate 和 endDate 应该怎样解读?
在源示例中,它们是以字符串形式给出的毫秒时间戳。构建日期之前先把它们转换成数字,并使用 venueInfo 的时区偏移来显示当地时间。
如果没有预定比赛会怎样?
覆盖范围取决于各球场可获得的数据,因此没有预定比赛的球场可能返回空的或缺失的 matchDetails 部分。请在界面中处理这种情况,不要假设列表一定有内容。
这个响应是否经过实时调用验证?
没有。该操作没有记录过探测调用。列出的字段来自被截断的源示例,所以在上线之前,请先用你自己的请求确认响应结构。