按 teamId 获取板球队的球员名单
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回某一支板球队的球员名单。唯一必填的路径参数是 teamId,即来自球队列表接口 teamId 字段的数字球队标识,默认示例值为 2。根据源响应示例,顶层是一个 player 数组,其中的行要么是角色标题行(名称如 BATSMEN、ALL ROUNDER、WICKET KEEPER 或 BOWLER,只带 imageId),要么是球员行,包含 id(字符串)、name、imageId、battingStyle,以及大多数非门将球员才有的 bowlingStyle。本接口没有记录过实时探测,这些字段来自未经验证的源示例,示例列表也可能被截断,请把可选的风格字段视为可能缺失。这里返回的是球队层面的球员名单,不是单场比赛的阵容,也不是某届赛事的阵容。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/teams-get-players API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/teams-get-players?key=<API_KEY>&teamId=2'
查询结果
使用场景
- 建立球队层面的球员目录,让每个条目链接到单个球员的个人简介和统计数据。
- 渲染按角色分组的阵容页:把没有 id 的行当作分组标题,把其后的行当作该角色下的球员。
- 在数据模型中把通用的球队球员名单与单场比赛阵容、赛事阵容区分开,不要把它当成首发十一人。
- 为某支选定球队制作球员姓名自动补全,使用返回的姓名和 ID 作为数据来源。
- 利用每个球员行上的风格字符串,为球探或梦幻板球研究视图做出击球手别和投球风格的筛选器。
常见问题
teams-get-players 接口会返回什么内容?
它返回由 teamId 指定的球队的球员名单。源示例中是一个 player 数组,里面有角色标题行和球员行,球员行包含 id、name、imageId、battingStyle,并且许多球员还有 bowlingStyle。
有效的 teamId 从哪里获取?
使用球队列表接口返回的 teamId 字段。预填的 2 只是默认示例值;在同类球队接口的源示例中,它对应印度队,但这一对应关系在这里没有得到验证。
如何区分角色标题行和真正的球员?
在源示例中,BATSMEN 或 BOWLER 这样的标题行只有 name 和 imageId,球员行则还带有 id。可以把缺少 id 的行视为标题,但在依赖这一规则之前,请先用实时响应确认。
它和单场比赛阵容或赛事阵容是同一回事吗?
不是。这里是通用的球队层面球员名单。比赛阵容和赛事阵容是另外的概念,所以不要假定返回的名单就是某场比赛的首发十一人。
battingStyle 和 bowlingStyle 一定存在吗?
不保证。在源示例中,门将行有 battingStyle 而没有 bowlingStyle,因此请把这两个字段都当作可选字段处理。
这个响应经过实时调用验证吗?
没有。本接口没有记录过探测调用。文档中的字段来自源响应示例,可能被截断,也可能与实时数据不同,所以上线之前请用你自己的请求进行验证。