按 teamId 获取板球队的球员名单

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

返回某一支板球队的球员名单。唯一必填的路径参数是 teamId,即来自球队列表接口 teamId 字段的数字球队标识,默认示例值为 2。根据源响应示例,顶层是一个 player 数组,其中的行要么是角色标题行(名称如 BATSMEN、ALL ROUNDER、WICKET KEEPER 或 BOWLER,只带 imageId),要么是球员行,包含 id(字符串)、name、imageId、battingStyle,以及大多数非门将球员才有的 bowlingStyle。本接口没有记录过实时探测,这些字段来自未经验证的源示例,示例列表也可能被截断,请把可选的风格字段视为可能缺失。这里返回的是球队层面的球员名单,不是单场比赛的阵容,也不是某届赛事的阵容。

API 功能

按 teamId 查询球队名单 传入球队列表接口返回的一个数字 teamId,就能得到属于该球队的球员名单。
角色标题行 源示例把 BATSMEN、ALL ROUNDER、WICKET KEEPER、BOWLER 等标题行与球员行交错排列,阵容页可以据此按角色分组。
名单行附带风格标签 球员行带有 battingStyle,并在有数据时带有 bowlingStyle 文本(例如 Right-hand bat 或 Left-arm orthodox),可用于筛选和球员资料卡片。
每位球员的 ID 与图片 ID 每个球员行都提供字符串 id 和数字 imageId,可作为键去关联球员详情、统计数据以及图片查询。
只有一个参数的 GET 请求 路径中只需要 teamId,所以名单页面不需要查询字符串、分页游标或请求体。

在线 API 演示

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

使用场景

常见问题

teams-get-players 接口会返回什么内容?

它返回由 teamId 指定的球队的球员名单。源示例中是一个 player 数组,里面有角色标题行和球员行,球员行包含 id、name、imageId、battingStyle,并且许多球员还有 bowlingStyle。

有效的 teamId 从哪里获取?

使用球队列表接口返回的 teamId 字段。预填的 2 只是默认示例值;在同类球队接口的源示例中,它对应印度队,但这一对应关系在这里没有得到验证。

如何区分角色标题行和真正的球员?

在源示例中,BATSMEN 或 BOWLER 这样的标题行只有 name 和 imageId,球员行则还带有 id。可以把缺少 id 的行视为标题,但在依赖这一规则之前,请先用实时响应确认。

它和单场比赛阵容或赛事阵容是同一回事吗?

不是。这里是通用的球队层面球员名单。比赛阵容和赛事阵容是另外的概念,所以不要假定返回的名单就是某场比赛的首发十一人。

battingStyle 和 bowlingStyle 一定存在吗?

不保证。在源示例中,门将行有 battingStyle 而没有 bowlingStyle,因此请把这两个字段都当作可选字段处理。

这个响应经过实时调用验证吗?

没有。本接口没有记录过探测调用。文档中的字段来自源响应示例,可能被截断,也可能与实时数据不同,所以上线之前请用你自己的请求进行验证。

相关接口

相关指南

查看订阅方案 →