按比赛 ID 与球队 ID 获取板球单场比赛中一支球队的阵容
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回一场板球比赛中某一支球队的阵容,由两个必填的数字路径参数确定:`matchId`(默认 35878)和 `teamId`(默认 9)。matchId 可从比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口获取,teamId 可从比赛详情分组中的比赛信息接口获取。该接口没有查询参数,因此无法按角色或类别筛选。该接口没有留存探测调用记录,下面的字段只来自一份被截断且未经验证的源示例:顶层是一个由分组构成的 `player` 数组,每个分组带有 `category` 标签(示例中出现 "playing XI" 和 "bench"),以及嵌套的 `player` 列表。示例中的每一行球员数据包含 `id`(字符串)、`name`、`role`(取值如 Batsman、Bowler、WK-Batsman 和 Batting Allrounder)、`teamname`,布尔值 `captain`、`keeper`、`isoverseas` 和 `isheader`,图片引用 `faceimageid`、`countryimageid` 和 `imageId`,以及文本字段 `battingStyle`、`bowlingStyle`、`battingsummary`、`bowlingsummary`、`inmatchchange` 和 `playingxichange`。其中不少文本字段在示例中是空字符串,请不要假定它们一定有内容。`category` 标签是唯一的选择线索,所以不要把列出的每位球员都当作已确认的首发十一人。数据覆盖取决于赛事和比赛状态,尚未公布阵容的比赛可能返回内容很少甚至为空的响应。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-team API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-team?key=<API_KEY>&matchId=35878&teamId=9'
查询结果
使用场景
- 利用比赛信息响应里的 matchId 与 teamId 组合,在比赛页面的球队标签中填入某一方已公布的阵容。
- 根据 captain 和 keeper 布尔值在阵容卡片上绘制队长与门将徽标,其他球员行不加标记。
- 按 category 标签把阵容图拆成首发和替补两组,同时不要假定这些分组名称是固定不变的。
- 在抛币前后各保存一次阵容响应并对比两份快照,若 inmatchchange 或 playingxichange 字段确实有内容,就可据此标出临时变动。
- 把每位球员的 id 关联到同一目录中的球员资料接口,让阵容条目可以跳转到球员详情页。
常见问题
单场球队阵容接口返回什么内容?
按说明,它返回一场比赛中某一支球队的阵容。唯一的依据是一份被截断的源示例:其中有一个由类别分组构成的 player 数组,分组内是带有 id、name、role、teamname 和若干标记的球员行。该接口没有留存探测调用记录,请对照真实响应核对结构。
哪些参数是必填的,这些 ID 从哪里获取?
matchId(默认 35878)和 teamId(默认 9)都是必填的路径参数。matchId 可使用比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口返回的值,teamId 可使用比赛详情分组中比赛信息接口返回的值。
列出的每位球员都会上场吗?
不一定。示例把球员分成 "playing XI" 和 "bench" 等类别分组,而且阵容也可能在最终十一人确定之前就已公布。请读取 category 标签,不要认为每一行都是确认的首发球员。
它与返回双方球队的接口有什么区别?
本接口需要 teamId,只返回其中一方的阵容,结果是一个球员数组。双方球队接口只需要 matchId,覆盖整场比赛,所以当你已经知道用户选了哪支球队时,请使用本接口。
id 的值是数字还是字符串?
在源示例中,每位球员的 id 是字符串,例如 "8345",而路径参数 matchId 和 teamId 是数字。保存或比较时请把球员 id 当作字符串处理,并对照真实响应确认这一点。
battingStyle 和 playingxichange 这类字段一定有值吗?
不一定。示例中的 battingStyle、bowlingStyle、battingsummary、bowlingsummary、inmatchchange 和 playingxichange 都是空字符串,部分图片引用的值为零。请把它们当作可选字段,并在界面中做好兜底显示。