按赛事 ID 查询板球系列赛登记的球队阵容列表

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

根据必填的数字路径参数 seriesId(取自系列赛列表或历史系列赛列表接口返回的 id 值)返回某一系列赛的阵容目录。来源响应示例包含 appIndex(seoTitle、webURL)、seriesId、seriesName 以及 squads 数组;数组中有两种行:标题行(isHeader 为 true,squadType 为 Test 之类的分组标签),以及阵容行(带有 squadId、squadType、teamId 和 imageId,其中 squadType 是阵容标签,示例中为球队名称)。响应只标识各个阵容,不包含球员名单。所列字段来自来源示例而非实际探测,因此阵容是否可用取决于该赛事的覆盖情况。

API 功能

单个系列赛的阵容目录 一个 seriesId 即可返回参加该赛事的各个阵容,是搭建赛事球队名单页面的起点。
赛制分组标题行 isHeader 为 true 且带有 Test 之类 squadType 的行代表列表中的一个分区,客户端无需硬编码赛制就能对阵容分组。
阵容与球队标识 每个阵容行都带有 squadId 和 teamId,前者用于阵容级别的查询,后者用于链接到球队页面。
阵容标签与队徽图片 阵容行上的 squadType 标签和 imageId 分别为目录中的每一项提供展示文字和队徽图片引用。
载荷中的系列赛上下文 响应会重复返回 seriesId 和 seriesName,并附带 appIndex 元数据,页面可据此确认加载的是哪个系列赛并设置标题。

在线 API 演示

GET /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、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 响应当作正常的空状态处理。

相关接口

相关指南

查看订阅方案 →