获取拍卖赛事、年份与默认选项列表

查看 板球数据 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 功能

拍卖赛事标识发现 读取文档记载的 seasons.tournament.tournaments 条目,获得机器可读的赛事标识与展示名称,其中包含文档列出的 IPL 和 WPL 两个选项。
可选拍卖年份列表 使用 seasons.year 数组生成年份下拉选项,客户端无需自行虚构一段固定的历史年份范围。
默认届次元数据 读取 defaults 对象,其源示例包含赛事和年份的默认选择;静态示例不应被当作永久有效的当前届次。
先选届次再查数据 把赛事和年份的选择与后续的球队或球员请求分开,让用户在明确的拍卖届次下继续查询。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

拍卖届次接口的响应包含哪些内容?

已保存的成功检查确认了 seasons.tournament、seasons.year、defaults 和 appIndex 四部分及其文档记载的对象或数组类型。源示例还展示了赛事标识与名称条目、默认赛事和年份,以及 appIndex 导航元数据;这些示例中的具体取值不保证是最新的。

赛事和年份参数的取值应该从哪里获取?

tournament 使用 seasons.tournament.tournaments 中的标识,year 使用 seasons.year 中的值。两个查询参数都是可选的,文档记载的请求默认值分别为 ipl 和 2026。

列出的每个年份对 IPL 和 WPL 都一定可用吗?

现有证据并未给出赛事与年份的可用性对照表,因此不要假设所列赛事与年份的每一种组合都受支持。

文档里的 2026 是否一定代表当前拍卖届次?

不是。它只是文档记载的请求默认值和示例值,并不保证是最新数据。准备届次选择时,请以返回的 defaults 为准。

能通过这个接口获取球队的拍卖购买情况吗?

不能。该响应仅用于发现赛事、年份和默认选项。请先通过拍卖球队列表获取球队标识,再使用单支球队拍卖接口查看文档记载的已购球员详情。

相关接口

相关指南

查看订阅方案 →