按角色分组列出板球比赛的球员,并附带梦幻板球标签。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →获取单场板球比赛的球员研究名单,按角色分组,并附带“状态火热”等梦幻板球标签。唯一输入是必填的数字型路径参数 matchId,可取自比赛列表、赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段,默认值为 151543。目前提供的探测记录中没有观察到该接口的实际响应,因此下文字段来自一份被截断且未经验证的源示例,仅作示意说明,不构成已验证的接口约定。示例包含 disclaimer 数组、legends 数组和 playerStyles 数组,以及 playersByRole。每个 playersByRole 条目带有角色名称(例如 WICKET KEEPERS)和 players 数组。示例中的每名球员包含 id、name、teamName、teamShortName、teamFlagId、faceImageId、isVisible、由 code/label 组成的 playerStyle 数组和 badges 数组,部分球员还带有一段关于状态或对位情况的简短 description。每个 legends 条目包含 code、label 和 desc,部分条目还有 color 和 isSeparate 字段。示例中出现的标签包括 In form、Injured、Off Field Pick、Ideal for Conditions 和 C/VC。该列表是按角色分组的研究名单,并不是确认的首发十一人,也不是梦幻积分总数,能否返回数据取决于所选比赛的覆盖情况。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/fantasy-list-players API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/fantasy-list-players?key=<API_KEY>&matchId=151543'
查询结果
使用场景
- 为单场比赛搭建梦幻板球研究选人面板,直接使用 playersByRole 中的角色分区,分别展示三柱门守门员、击球手等球员。
- 为“状态火热”和“适合当前场地条件”标签添加筛选按钮,让分析师把很长的球员列表缩小到被标记的名字。
- 把每名球员的 id 对接独立的球员资料查询,用户点选某一行时打开带比赛背景的球员资料页。
- 在赛前阵容浏览页中把 Injured 标签显示为风险提示,同时提醒读者最终名单要以官方公布的队伍名单为准。
- 将 teamShortName 与每名球员及球队旗帜返回的图片 ID 结合,渲染带球队标识的名单卡片。
常见问题
这个接口的 matchId 从哪里获取?
使用比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段。它是必填的数字型路径参数,默认值为 151543。
返回的名单就是确认的首发十一人吗?
不是。该接口的定位是按角色分组、附带梦幻标签的比赛全部球员。请把它当作研究名单,在把它当作首发十一人展示之前,应先对照已公布的队伍名单确认最终阵容。
这些标签分别代表什么?
未经验证的源示例中带有 legends 数组,定义了这些代码:In form、Injured、Off Field Pick、Ideal for Conditions 和 C/VC。每名球员的 badges 数组列出适用于他的代码,也可能为空。
文档中列出了哪些响应字段,它们是否被实际观察到?
源示例展示了 disclaimer、legends、playerStyles 和 playersByRole,每名球员包含 id、name、球队字段、图片 ID、playerStyle、badges 以及可选的 description。示例被截断,且该接口没有观察到探测响应,所以这些字段只能视为示意,不能当作已验证的结果。
它会返回梦幻积分或球员价格吗?
文档示例中没有这类字段。它提供的是角色、标签、风格标签和点评文字,积分、身价或薪资数值请从其他数据源获取。
如果某场比赛没有梦幻数据会怎样?
覆盖情况因比赛而异,文档也没有说明没有梦幻内容的比赛会返回什么。请在客户端中妥善处理 playersByRole 为空或缺失的情况。