按系列赛 ID 和阵容 ID 获取板球某支参赛阵容的球员名单

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

返回某一届板球系列赛中一支参赛阵容的球员名单。两个路径参数都是必填的数字:seriesId 取自系列赛列表或历史系列赛列表接口返回的 id 字段,squadId 取自本产品系列赛阵容接口返回的 squadId 字段。源响应示例记录的是一个扁平的球员数组,其中混合了两类条目:分组标题行带有 isHeader 为 true 和 name(如 BATTERS、ALL ROUNDERS、WICKET KEEPERS、BOWLERS);球员行包含 id(字符串)、name、role、imageId(数字)、battingStyle,多数球员还有 bowlingStyle,被标记为队长的球员会多出一个 captain 标记。文档中还给出了返回空对象的 204 示例。以上字段来自源示例而不是实际探测调用,因此 bowlingStyle、captain 以及分组标题名称都应视为取决于数据覆盖情况的可选内容。

API 功能

双标识阵容查询 用 seriesId 加 squadId 就能定位某一届赛事中的一支阵容,得到的是该届赛事的名单,而不是跨越所有赛事的球队通用名单。
按位置划分的标题行 isHeader 为 true 且 name 为 BATTERS、ALL ROUNDERS、WICKET KEEPERS 或 BOWLERS 的条目,可以帮助客户端把扁平数组切分成几个板块。
球员 ID、姓名与角色 每个球员行都带有字符串类型的 id、name 以及 role 角色标签,例如 Batsman、Batting Allrounder、Bowling Allrounder、WK-Batsman 或 Bowler。
击球与投球风格 battingStyle(如 Right-hand bat)与 bowlingStyle(如 Right-arm offbreak)描述每位球员的技术特点;示例中有些球员没有 bowlingStyle 字段。
可选的队长标记 示例中只有被标记为队长的球员带有布尔型 captain 字段,其他行省略该键,因此字段缺失就表示没有被标记。
文档化的空响应 源文档还给出了返回空对象的 204 示例,所以没有公布球员的阵容可以在界面上作为明确的空状态展示。

在线 API 演示

GET /api/project/cricbuzz-cricket/series-get-players

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-get-players?key=<API_KEY>&seriesId=3718&squadId=15826'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

seriesId 和 squadId 从哪里获取?

seriesId 取自系列赛列表或历史系列赛列表接口返回的 id 字段,然后调用该系列赛的阵容接口,从中选取想要的阵容的 squadId。默认值 3718 和 15826 只是示例值,这个接口也没有留存探测调用记录。

球员数组里为什么有些条目没有 id?

它们是 isHeader 为 true 的板块标题行,name 类似 BATTERS 或 BOWLERS。把带 isHeader 的行当作标题,其余的行当作球员,再把球员归入最近出现的那个标题之下即可。

这是某场比赛的首发十一人吗?

不是。它列出的是一届系列赛里某支阵容的球员,并不说明具体某场比赛选了哪些球员。需要单场信息时,请使用带 matchId 的比赛类接口。

为什么有的球员没有 bowlingStyle?

在源示例中,bowlingStyle 出现在许多行里,但另一些行没有,所以应把它当作可选字段。captain 键也是同样的情况:只有被标记为队长的球员才会出现。

id 和 imageId 分别是什么类型?

在源示例中,id 是字符串,imageId 是数字。imageId 只是一个引用而不是 URL,响应里也没有图片链接,所以需要在客户端里显式做类型转换。

返回 204 或空对象是什么意思?

源文档记录了一个响应体为空对象的 204 示例。请把它当作该 seriesId 与 squadId 组合暂时没有球员名单,而不是错误来处理,也不要自动改用其他 id 重试。

相关接口

相关指南

查看订阅方案 →