按角色获取单支拍卖球队的已购球员
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →获取一支拍卖球队文档记载的已购球员视图,按角色分组,并在有数据时附带球队策略信息。必填的数字型 teamId 路径参数来自拍卖球队列表,文档示例 58 对应 CSK。可选的 currency、tournament 和 year 查询参数分别用于选择价格显示币种和拍卖届次,文档记载的默认值为 INR、ipl 和 2026。 本操作没有已保存的技术探测记录。其未经验证且被截断的源示例展示了一个 allroundersList 数组,包含 playerId、playerName、playerImageId、country、countryId、role、cappedStatus、isPlayerOverseas、playsFor、playsForTeam、teamImageId 和 season。与购买相关的字段包括 auctionStatus、auctionPrice、basePrice、totalEarnings 和 updatedTime。价格为展示用字符串,totalEarnings 可能是 -- 之类的占位符,因此不要假设所有金额字段都是数字。源描述记载了按角色分组和球队策略,但被截断的示例并未说明完整的角色分组集合,也未说明策略字段的结构。 请把它当作所选届次的拍卖购买记录,而不是完整的保留阵容、确认的比赛日首发名单,或对球队表现的预测。文档给出的币种示例有 INR、USD 和 GBP;未知币种值会返回不带货币符号的价格。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/auction-get-team API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/auction-get-team?key=<API_KEY>&teamId=58¤cy=INR&tournament=ipl&year=2026'
查询结果
使用场景
- 为选定球队制作拍卖后的购入页面,把球员姓名按返回的角色分组排列。
- 为编辑准备球队组建复盘,区分新买入球员、保留球员和比赛日出场人选。
- 以用户选择的文档币种展示已购球员卡片,呈现成交价、底价和成交状态。
- 在已购球员档案中加入国籍、是否有资格代表国家队和外援标签,并保留 playerId 供用户另行发起球员详情查询。
常见问题
如何找到这个请求所需的 teamId?
请从你要查看的那一届拍卖球队列表接口中读取 teamId。teamId 是必填的数字型路径参数;58 是文档中的 CSK 示例,并不保证每个赛事和年份都有对应数据。
它返回完整球队阵容还是比赛日首发十一人?
文档记载的用途是按角色分组展示在拍卖中买入的球员,并附带球队策略信息。不要把它当作完整的保留阵容或已公布的比赛日首发名单。
现有示例中记载了哪些球员字段?
未经验证的源示例展示了 allroundersList 条目,包含球员身份、角色、国籍、是否有资格代表国家队与外援状态、球队引用、赛季、auctionStatus、auctionPrice、basePrice、totalEarnings 和 updatedTime。示例被截断,因此不能说明完整响应。
拍卖价格可以请求哪些币种?
INR 是文档记载的默认值;USD 和 GBP 也是文档给出的示例。该参数是自由格式的字符串,并非经过确认的完整币种列表。未知值按文档会返回不带货币符号的价格。
auctionPrice 和 basePrice 是数字金额吗?
现有示例中它们是格式化后的字符串,可能带有货币符号和数量级标记。请保留其显示含义,并处理 -- 之类的占位值,不要假设每个金额字段都是数字。
策略字段和全部角色分组已经验证过了吗?
没有。本操作没有已保存的技术探测记录。源描述提到了策略和按角色分组,但被截断的示例只展示了 allroundersList,既没有证实策略的数据结构,也没有给出完整的角色分组列表。