按赛事 ID 查询循环举办的板球系列赛的全部届次

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

根据必填的数字路径参数 seriesId(取自系列赛列表或历史系列赛列表接口返回的 id 值)返回某项定期举办赛事的历届记录。来源响应示例包含 seasons 数组,每个届次带有 id、name、shortName、season(年份标签)、seriesType、host(以逗号分隔的主办国家)、以毫秒时间戳字符串表示的 startDate 和 endDate、isArchived,以及 winner 和 runnerUp 球队对象(teamId、teamName、teamSName、imageId、isActive、isLeagueTeam、teamPriority,部分球队还带有 isVideoPresent)。没有历届记录的系列赛会返回 HTTP 204 和空响应体;测试中只有 IPL 各届返回了届次数据,因此不要假定其他循环赛事同样可用。所列字段来自来源示例而非实际探测。

API 功能

单项赛事的历届记录 一个 seriesId 即可返回某项定期联赛的全部届次,档案页无需逐届单独查询就能列出每一届。
冠军与亚军球队 每个届次都内嵌 winner 和 runnerUp 球队对象,包含 teamId、teamName、teamSName 和 imageId,可直接做成带队徽的历届冠军表。
届次标识与展示标签 id、name、shortName、season 和 seriesType 字段提供届次级别的 seriesId,以及届次名称、年份等展示标签。
主办国家与时间范围 host 字符串可能列出多个国家,startDate 和 endDate 时间戳标明每一届的举办时段。
存档状态标记 每个届次的布尔字段 isArchived 用来区分已结束的届次和仍在进行的届次,便于给历史列表排序并加上标识。
明确的无历届信号 没有历届记录的系列赛会返回 HTTP 204 且无内容,这是展示空状态而不是报出解析错误的明确提示。

在线 API 演示

GET /api/project/cricbuzz-cricket/series-get-seasons

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

哪些系列赛会返回届次数据?

测试中只有 IPL 各届返回了数据,其他系列赛返回 HTTP 204。这只是对已测试 id 的观察,并不保证所有循环赛事都如此,所以客户端里请保留对 204 的处理分支。

HTTP 204 响应是什么样的?

它表示该系列赛没有历届记录。来源文档说明这种情况下响应体为空,所以解析 JSON 之前先检查状态码,并显示无历史记录的提示,而不是空表格。

可以传入任意一届的 id 吗?

来源示例中,默认 seriesId 9237(IPL 2025 届)出现在返回的 seasons 数组里,与其他各届并列,这说明该赛事任意一届的 id 应该都可以使用。不过这来自来源示例而非实际探测,请用你自己的 id 验证。

日期是什么格式?

在来源示例中,startDate 和 endDate 是以字符串形式序列化的毫秒时间戳。展示届次时间段之前,请先在客户端完成转换。

这个接口会列出每一届的比赛吗?

不会。它只返回各届的摘要信息。把某一届的 id 作为 seriesId 传给本产品的系列赛比赛或球队名单接口,即可加载该届的赛程或阵容。

到哪里找可以作为起点的 seriesId?

使用系列赛列表或历史系列赛列表接口返回的 id 字段。默认值 9237 是来源文档中的示例值。

相关接口

相关指南

查看订阅方案 →