按系列赛 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 之后,打开某一支阵容的完整球员名单。
- 为某届赛事的参赛阵容搭建专属名单页,而不是套用全局球队名单,也不去猜测单场比赛的首发十一人。
- 渲染阵容名单表,用标题行作为击球手、全能球员、三柱门守门员和投球手几个板块的标题。
- 在阵容公布卡片上,通过检查每个球员行的可选 captain 标记来突出显示队长。
- 撰写赛前前瞻文章时,对比一支阵容的击球手习惯与投球风格构成。
- 把阵容中的球员 id 和 imageId 收集起来,作为球员详情页的关联键,前提是先确认它们与下游接口所需的格式一致。
常见问题
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 重试。