按比赛 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 功能

一次请求获取双方阵容 只需带上 matchId 发起一次 GET 请求,就能拿到整场比赛双方的阵容,赛前预览页面不必查找球队标识,也不必发送两次独立请求。
按类别分组的各队球员 在源示例中,第一支球队的 players 列表被分成 "playing XI" 等类别分组,每组下是各自的球员行,让首发和候补球员保持分开。
用于阵容页面的标题与链接字段 示例中的 appindex 对象包含 seotitle 和 weburl 字符串,可为阵容页面提供标题和分享链接,前提是你实际收到的响应里带有这两项。
用于阵容均衡分析的角色与徽标字段 球员行带有 role 字符串,以及 captain、keeper 和 isoverseas 布尔值,足以统计每一方的击球手、投球手、全能球员和门将人数。
单场阵容,而非系列赛阵容 数据与所请求的这场比赛绑定,与系列赛范围的阵容列表是不同的视图,所以这里展示的阵容可能与整个赛事的大名单不一致。
第二支球队的键名尚未确认 被截断的示例里只出现了 team1。在编写遍历双方球队的代码之前,请先查看真实响应,找出存放对手一方的键。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

比赛双方阵容接口返回什么内容?

按说明,它返回一场比赛中双方球队的阵容。唯一的依据是一份被截断的源示例:包含一个 appindex 对象和一个 team1 对象,其 players 列表按类别对球员行分组。该接口没有留存探测调用记录,请对照真实响应核对完整结构。

哪个参数是必填的,matchId 从哪里获取?

只有数字路径参数 matchId 是必填项(默认 41881)。可使用比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口返回的 matchId。该接口不接受 teamId,也没有任何查询参数。

它与单支球队阵容接口有什么区别?

本接口只需要 matchId,覆盖一场比赛的双方。单支球队接口需要 matchId 和 teamId,只返回其中一方的球员数组。当某个页面要同时展示两份阵容时,请选择本接口。

这些就是确认的首发十一人吗?

默认不是。示例把球员归入 "playing XI" 等类别标签下,但阵容可能在最终十一人确定之前就已公布。请读取 category 的值,不要把列出的每位球员都当作确认的首发球员。

第二支球队在响应的什么位置?

所提供的示例在第一支球队之后就被截断,所以另一方的键名在这里无法确认。请针对你的比赛获取一份真实响应,先检查顶层键,再去遍历双方球队。

可以把 faceimageid 当作球员的唯一键吗?

不可以。在示例中,有多位球员共用同一个 faceimageid 值,部分图片引用的值为零。请使用球员 id(示例中为字符串)作为标识,把图片引用当作可选的显示提示。

如果一场比赛没有阵容数据怎么办?

数据覆盖取决于赛事和比赛状态,尚未公布阵容的比赛可能返回内容很少甚至为空的响应。请在界面中处理这种情况,不要把它当作错误。

相关接口

相关指南

查看订阅方案 →