按姓名在指定届次中搜索拍卖球员
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →使用必填的 plrN 姓名查询参数搜索拍卖参与球员,文档示例为 Kohli。可选的 tournament(ipl 或 wpl)和字符串型 year 用于选定拍卖届次,配置的默认值为 ipl 和 2026。可用的届次取值由拍卖赛季接口给出。匹配规则、分页方式和结果完整性均未说明。未经验证的文档示例返回 auctionPlayersList,以及 auctionTitle、liveBlogId 和 appIndex。示例列表中的每个条目包含 playerId、playerName、playerImageId、country、countryId、role、cappedStatus、season、auctionStatus、auctionPrice、basePrice、playsFor、playsForTeam、teamImageId、totalEarnings、updatedTime、id,以及文本数组 playerIntro。可用返回的 playerId 继续查询拍卖球员详情。该搜索未声明 currency 参数。已保存的探测记录中没有观察到该接口的实际响应;文档示例无法证明哪些字段一定存在,也无法说明没有匹配球员时的行为。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/auction-search-players API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/auction-search-players?key=<API_KEY>&plrN=Kohli&tournament=ipl&year=2026'
查询结果
使用场景
- 提供按届次区分的姓名选择器,让编辑先选定一位拍卖参与球员,再打开该球员的详情记录。
- 当结果中包含相应字段时,在名字相近的候选球员旁显示国家、角色和球队信息,帮助用户区分。
- 搭建新闻编辑部的搜索面板,把提交的球员姓名和所选拍卖届次与返回的候选列表一并保存。
- 让读者在 IPL 和 WPL 视图中重复同一个姓名查询,而不会悄悄混入不同拍卖届次的球员。
常见问题
必填的 plrN 查询参数应填什么?
plrN 是要搜索的球员姓名,以字符串形式提交,配置的示例为 Kohli。文档没有说明是否支持模糊匹配、是否区分大小写,也没有给出最短查询长度。
这个搜索会覆盖全局球员库里的所有球员吗?
它是按 tournament 和 year 划定范围的拍卖球员搜索。可选的 tournament 取值为 ipl 和 wpl,默认值为 ipl 和 2026 年。文档未说明该接口是否覆盖全局球员库。
哪个字段能把搜索结果与球员拍卖详情接口关联起来?
未经验证的响应示例在 auctionPlayersList 的每个条目中都包含 playerId。把该 ID 传给拍卖球员详情接口,并保留原来想查询的 tournament 和 year 即可。
按姓名搜索时可以选择价格货币吗?
不可以,该搜索没有声明 currency 查询参数。源示例虽然包含 auctionPrice 和 basePrice,但并未说明它们使用哪种货币。如需明确的货币输入,请改用球员详情或球员列表接口。
没有匹配的拍卖球员时,应用应该如何处理?
已保存的探测响应没有确认该搜索在无匹配时的行为。文档示例包含 auctionPlayersList,但并不保证未匹配的姓名一定返回空数组,也不保证返回特定的错误结构。