按比赛 ID 获取板球一场比赛中双方球队的阵容
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回一场板球比赛中双方球队的阵容,由唯一必填的数字路径参数 `matchId`(默认 41881)确定。matchId 可从比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口获取。该接口没有查询参数,也不需要 teamId,所以响应总是覆盖整场比赛。该接口没有留存探测调用记录,下面的字段只来自一份被截断且未经验证的源示例:一个包含 `seotitle` 和 `weburl` 字符串的 `appindex` 对象,以及一个 `team1` 对象,其 `players` 列表由类别分组构成(示例中出现 "playing XI"),每个分组带有嵌套的 `player` 列表。每一行球员数据包含 `id`(字符串)、`name`、`role`(取值如 Batter、Bowler、WK-Batter 和 Batting Allrounder)、`teamname`,布尔值 `captain`、`keeper`、`isoverseas` 和 `isheader`,图片引用 `faceimageid`、`countryimageid` 和 `imageId`,以及文本字段 `battingStyle`、`bowlingStyle`、`battingsummary`、`bowlingsummary`、`inmatchchange` 和 `playingxichange`。示例在出现第二支球队之前就被截断,所以这里无法确认存放另一方的键名。单场比赛的阵容不同于整个系列赛的阵容,除非类别标签明确说明,否则列出的球员不能视为已确认的首发十一人。数据覆盖取决于赛事和比赛状态。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-teams API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-teams?key=<API_KEY>&matchId=41881'
查询结果
使用场景
- 在比赛预览页面中,仅凭一个 matchId 并排展示双方阵容,每一方的球员按类别分组。
- 为赛前文章模板填入双方名单,并附上每一方的队长和门将标记。
- 为赛事伴侣应用构建阵容均衡表,统计每支球队的击球手、投球手、全能球员和门将等角色数量。
- 当某个页面总是同时需要双方阵容时,用一次调用代替两次单队请求,并以 matchId 为键缓存合并后的响应。
- 在编辑工具里把单场阵容与系列赛大名单区分开,让撰稿人清楚看到这场比赛实际报出了哪些球员。
常见问题
比赛双方阵容接口返回什么内容?
按说明,它返回一场比赛中双方球队的阵容。唯一的依据是一份被截断的源示例:包含一个 appindex 对象和一个 team1 对象,其 players 列表按类别对球员行分组。该接口没有留存探测调用记录,请对照真实响应核对完整结构。
哪个参数是必填的,matchId 从哪里获取?
只有数字路径参数 matchId 是必填项(默认 41881)。可使用比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口返回的 matchId。该接口不接受 teamId,也没有任何查询参数。
它与单支球队阵容接口有什么区别?
本接口只需要 matchId,覆盖一场比赛的双方。单支球队接口需要 matchId 和 teamId,只返回其中一方的球员数组。当某个页面要同时展示两份阵容时,请选择本接口。
这些就是确认的首发十一人吗?
默认不是。示例把球员归入 "playing XI" 等类别标签下,但阵容可能在最终十一人确定之前就已公布。请读取 category 的值,不要把列出的每位球员都当作确认的首发球员。
第二支球队在响应的什么位置?
所提供的示例在第一支球队之后就被截断,所以另一方的键名在这里无法确认。请针对你的比赛获取一份真实响应,先检查顶层键,再去遍历双方球队。
可以把 faceimageid 当作球员的唯一键吗?
不可以。在示例中,有多位球员共用同一个 faceimageid 值,部分图片引用的值为零。请使用球员 id(示例中为字符串)作为标识,把图片引用当作可选的显示提示。
如果一场比赛没有阵容数据怎么办?
数据覆盖取决于赛事和比赛状态,尚未公布阵容的比赛可能返回内容很少甚至为空的响应。请在界面中处理这种情况,不要把它当作错误。