按赛事 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 历史页面,列出每一届赛事,并把各届的 id 链接到对应的赛程和球队名单。
- 为赛事页面添加届次切换器,访客只需从一个 seriesId 出发就能在循环联赛的各届之间切换。
- 制作冠军与亚军对照表,按年份展示球队名称、简称以及通过 imageId 获取的队徽。
- 接口返回 HTTP 204 时展示无历届记录的状态,而不是渲染空列表或错误提示条。
- 读取 isArchived 以及起止日期来建立档案索引,把已结束的届次与当前届次区分开。
常见问题
哪些系列赛会返回届次数据?
测试中只有 IPL 各届返回了数据,其他系列赛返回 HTTP 204。这只是对已测试 id 的观察,并不保证所有循环赛事都如此,所以客户端里请保留对 204 的处理分支。
HTTP 204 响应是什么样的?
它表示该系列赛没有历届记录。来源文档说明这种情况下响应体为空,所以解析 JSON 之前先检查状态码,并显示无历史记录的提示,而不是空表格。
可以传入任意一届的 id 吗?
来源示例中,默认 seriesId 9237(IPL 2025 届)出现在返回的 seasons 数组里,与其他各届并列,这说明该赛事任意一届的 id 应该都可以使用。不过这来自来源示例而非实际探测,请用你自己的 id 验证。
日期是什么格式?
在来源示例中,startDate 和 endDate 是以字符串形式序列化的毫秒时间戳。展示届次时间段之前,请先在客户端完成转换。
这个接口会列出每一届的比赛吗?
不会。它只返回各届的摘要信息。把某一届的 id 作为 seriesId 传给本产品的系列赛比赛或球队名单接口,即可加载该届的赛程或阵容。
到哪里找可以作为起点的 seriesId?
使用系列赛列表或历史系列赛列表接口返回的 id 字段。默认值 9237 是来源文档中的示例值。