按球队 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 搭建以 teamId 为键的关注球队赛程页面,按日期列出接下来的比赛。
- 生成本地提醒候选清单,但必须先核对返回的比赛时间及其变动;该接口本身并不是推送通知服务。
- 把毫秒级开赛时间戳转换为用户所在时区,将球队接下来的主客场日期导出到日历。
- 利用返回的第一场比赛的开赛时间和系列赛名称,为所选球队制作巡回赛倒计时组件。
- 列出球队接下来几场比赛的球场、城市与时区,用于提前规划差旅或转播覆盖。
常见问题
teams-get-schedules 接口会返回什么内容?
返回 teamId 所指球队的已排定比赛。源示例中的 teamMatchesData 条目按日期标签分组,每个条目带有 matchInfo,描述该场比赛、对手、系列赛和场地。
为什么操作名称是复数,路径却是 /schedule?
该操作命名为 teams-get-schedules,但请求路径以 /schedule 结尾。请严格按文档写明的路径调用,并把占位符替换为你的 teamId。
有效的 teamId 从哪里获取?
使用球队列表接口返回的 teamId 字段。预填的 2 只是默认示例值,该操作的源示例显示它返回的是名为 India 的球队的赛程。
它会发送提醒或推送通知吗?
不会。它只返回赛程数据。如果你要做提醒功能,请在通知任何人之前先核对返回的开赛时间,并重新检查是否有变动。
应该如何理解比赛的开赛时间?
源示例中的 startDate 和 endDate 是毫秒时间戳字符串,而 status 与 hideScoreStatus 是便于阅读的 GMT 开赛文字。把时间当作最终时间之前,请先检查 isTimeAnnounced。
为什么有些条目是 adDetail 而不是赛程?
源示例在各赛程分组之间穿插了广告位对象。构建赛程列表时,请跳过没有 matchDetailsMap 的条目。该操作没有记录过实时探测,请用真实响应加以确认。