按角色分组列出板球比赛的球员,并附带梦幻板球标签。

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

按角色分组的球员名单 playersByRole 把一场比赛的球员归入 WICKET KEEPERS 等角色标签之下,选人面板或研究表格可以直接按分区渲染,无需在客户端重新分组。
内置梦幻标签图例 legends 数组为每个标签代码给出 label 和说明(In form、Injured、Off Field Pick、Ideal for Conditions、C/VC),方便你向用户解释球员旁边显示的每一种标签。
击球与投球风格标签 每名球员带有由 code 和 label 组成的 playerStyle 列表,例如右手击球手,playerStyles 字典则说明所有可能的风格代码。
球队与图片引用 ID 球员数据包含 id、teamShortName、teamName、teamFlagId 和 faceImageId,可作为稳定的键去关联球员资料,也便于制作带球队标识的名单卡片。
可选的球员点评文字 部分球员附有简短的 description,说明近期状态或对位背景,可作为提示气泡或可展开的备注,显示在标签旁边。

在线 API 演示

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

使用场景

常见问题

这个接口的 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 为空或缺失的情况。

相关接口

相关指南

查看订阅方案 →