按球队 ID 查询板球球队即将进行的赛程,返回开赛时间、赛制、系列赛、对手与比赛场地

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

返回某一支板球球队的已排定赛程。唯一必填的路径参数是 teamId,即数字类型的球队 ID,取自球队列表接口返回的 teamId 字段,默认示例值为 2。请求路径以 /schedule 结尾。根据源响应示例,返回内容包含带有导航信息的 appIndex 对象和 teamMatchesData 数组。赛程条目使用 matchDetailsMap,其键为 Tue, 06 Oct 2026 这样的日期标签,并带有 match 数组和 seriesId。每场比赛的 matchInfo 包括 matchId、matchDesc、matchFormat,取值如 Preview 或 Upcoming 的 state,形如 Match starts at Oct 06, 13:30 GMT 的 status 与 hideScoreStatus 文字,isTimeAnnounced,以毫秒时间戳字符串表示的 startDate 与 endDate,seriesId、seriesName 及系列赛的开始与结束日期,含 teamId、teamName、teamSName 和 imageId 的 team1 与 team2,以及含 id、ground、city 和 timezone 的 venueInfo。数组中部分条目是广告位,只包含 adDetail 对象而没有赛程数据。本接口没有记录过实时探测,上述字段均来自未经验证、可能被截断的源示例。文档中也没有分页或日期范围参数。

API 功能

按日期标签分组的赛程 在源示例中,每个 matchDetailsMap 条目都以 Tue, 06 Oct 2026 这样的日期标签为键并带有 seriesId,赛程视图因此可以按天渲染分段。
开赛时间字段 matchInfo 以毫秒时间戳字符串给出 startDate 和 endDate,并提供 isTimeAnnounced 标志以及 Match starts at Oct 09, 13:30 GMT 这样的状态文字,可用于倒计时或日历展示。
赛程状态标签 state 字段可以区分 Preview 和 Upcoming 等状态,matchDesc 则在系列赛内标明具体场次,例如 1st T20I 或 4th T20I。
每场比赛的对手与场地 team1 和 team2 返回球队 ID、名称和简称,venueInfo 再补充球场、城市、场地 ID 和时区,每场比赛都能显示球队在哪里、对阵谁。
每场比赛附带系列赛背景 seriesId、seriesName 以及系列赛的开始和结束日期会在每场比赛中重复出现,无需再次查询就能把赛程链接到对应的巡回赛页面。

在线 API 演示

GET /api/project/cricbuzz-cricket/teams-get-schedules

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

teams-get-schedules 接口会返回什么内容?

返回 teamId 所指球队的已排定比赛。源示例中的 teamMatchesData 条目按日期标签分组,每个条目带有 matchInfo,描述该场比赛、对手、系列赛和场地。

为什么操作名称是复数,路径却是 /schedule?

该操作命名为 teams-get-schedules,但请求路径以 /schedule 结尾。请严格按文档写明的路径调用,并把占位符替换为你的 teamId。

有效的 teamId 从哪里获取?

使用球队列表接口返回的 teamId 字段。预填的 2 只是默认示例值,该操作的源示例显示它返回的是名为 India 的球队的赛程。

它会发送提醒或推送通知吗?

不会。它只返回赛程数据。如果你要做提醒功能,请在通知任何人之前先核对返回的开赛时间,并重新检查是否有变动。

应该如何理解比赛的开赛时间?

源示例中的 startDate 和 endDate 是毫秒时间戳字符串,而 status 与 hideScoreStatus 是便于阅读的 GMT 开赛文字。把时间当作最终时间之前,请先检查 isTimeAnnounced。

为什么有些条目是 adDetail 而不是赛程?

源示例在各赛程分组之间穿插了广告位对象。构建赛程列表时,请跳过没有 matchDetailsMap 的条目。该操作没有记录过实时探测,请用真实响应加以确认。

相关接口

相关指南

查看订阅方案 →