按赛事 ID 查询板球系列赛登记的球队阵容列表
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →根据必填的数字路径参数 seriesId(取自系列赛列表或历史系列赛列表接口返回的 id 值)返回某一系列赛的阵容目录。来源响应示例包含 appIndex(seoTitle、webURL)、seriesId、seriesName 以及 squads 数组;数组中有两种行:标题行(isHeader 为 true,squadType 为 Test 之类的分组标签),以及阵容行(带有 squadId、squadType、teamId 和 imageId,其中 squadType 是阵容标签,示例中为球队名称)。响应只标识各个阵容,不包含球员名单。所列字段来自来源示例而非实际探测,因此阵容是否可用取决于该赛事的覆盖情况。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/series-get-squads API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-get-squads?key=<API_KEY>&seriesId=3718'
查询结果
使用场景
- 把所选系列赛关联的阵容列成赛事球队名单目录。
- 在加载球员之前先在该系列赛内解析出 squadId,并在页面导航上下文中保留 seriesId。
- 利用位于每组阵容之前的 isHeader 行把阵容页面拆分成多个分区,例如示例中的 Test 标题行。
- 通过 teamId 把每个阵容条目链接到球队页面,并用 imageId 显示其队徽。
- 根据系列赛中列出的阵容为赛事页面生成球队筛选器。
常见问题
这个接口会返回球员姓名吗?
不会。文档示例只列出阵容行,包含 squadId、squadType、teamId 和 imageId。需要球员名单时,请把 squadId 用于阵容级别的球员查询。
squads 数组里的 isHeader 行是什么?
它们是 isHeader 为 true 的分区标记,带有分组标签 squadType,在来源示例中为 Test。可以把它们当作标题使用,也可以跳过,因为这些行没有 squadId 或 teamId。
为什么阵容行的 squadType 显示的是球队名称?
在来源示例中,阵容行用 squadType 作为阵容标签(例如某支省级球队的名称),而标题行用它表示赛制分组。请把它当作展示标签,用 squadId 和 teamId 来识别身份。
默认的 seriesId 指向哪个系列赛?
来源响应示例中,默认值 3718 对应 2021-22 赛季的 Plunket Shield 系列赛。请把它替换为系列赛列表或历史系列赛列表接口返回的 id。
每个系列赛都有阵容数据吗?
不一定。阵容数据取决于该赛事的覆盖情况,这里也没有实际探测记录,所以请把空的 squads 数组或非 200 响应当作正常的空状态处理。