获取拍卖赛事、年份与默认选项列表
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →在为球队或球员查询选定拍卖届次之前,先用本接口查看可用的拍卖赛事标识、可选年份以及默认选项。可选的 tournament 和 year 查询参数分别取自 seasons.tournament.tournaments 中的标识和 seasons.year 中的年份值,文档记载的请求默认值为 ipl 和 2026。 已保存的一次成功 HTTP 200 检查确认:返回 JSON 对象,其中 seasons.tournament 为对象、seasons.year 为数组、defaults 为对象、appIndex 为对象。源示例还记录了 seasons.tournament.tournaments 中带有 identifier 和 title 的条目、带有 identifier 和 title 的 defaults.tournament、defaults.year,以及作为导航元数据的 appIndex.seoTitle 和 appIndex.webURL。这些嵌套示例字段及其具体取值并未被该检查逐一验证。 请以接口实际返回的选项为准,不要默认文档示例中的年份就是当前默认年份,也不要假设每个列出的年份对 IPL 和 WPL 都可用。本接口只用于发现可选届次,不返回已购球员名单或球队预算。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/auction-list-seasons API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/auction-list-seasons?key=<API_KEY>&tournament=ipl&year=2026'
查询结果
使用场景
- 利用文档记载的赛事列表中的标识和名称,搭建 IPL/WPL 拍卖届次选择器。
- 根据 seasons.year 动态生成拍卖档案的年份选择控件,而不是在代码里硬编码年份范围。
- 用返回的 defaults 给出初始拍卖选项建议,同时允许用户确认或改选其他届次。
- 在用户提交拍卖球队预算或已购球员请求之前,提供一个手动选择届次的步骤。
常见问题
拍卖届次接口的响应包含哪些内容?
已保存的成功检查确认了 seasons.tournament、seasons.year、defaults 和 appIndex 四部分及其文档记载的对象或数组类型。源示例还展示了赛事标识与名称条目、默认赛事和年份,以及 appIndex 导航元数据;这些示例中的具体取值不保证是最新的。
赛事和年份参数的取值应该从哪里获取?
tournament 使用 seasons.tournament.tournaments 中的标识,year 使用 seasons.year 中的值。两个查询参数都是可选的,文档记载的请求默认值分别为 ipl 和 2026。
列出的每个年份对 IPL 和 WPL 都一定可用吗?
现有证据并未给出赛事与年份的可用性对照表,因此不要假设所列赛事与年份的每一种组合都受支持。
文档里的 2026 是否一定代表当前拍卖届次?
不是。它只是文档记载的请求默认值和示例值,并不保证是最新数据。准备届次选择时,请以返回的 defaults 为准。
能通过这个接口获取球队的拍卖购买情况吗?
不能。该响应仅用于发现赛事、年份和默认选项。请先通过拍卖球队列表获取球队标识,再使用单支球队拍卖接口查看文档记载的已购球员详情。