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

双 ID 阵容查询 路径同时接收 matchId 和 teamId,一次 GET 请求就能拿到某场比赛中单独一方的阵容,不必下载两支球队的全部数据。
按类别标签分组的球员 源示例把球员行嵌套在标注为 "playing XI" 和 "bench" 的类别分组下,客户端可以把首发阵容和替补分成两个区块来展示。
每行球员都有角色文字 示例中的每一行都带有 role 字符串,例如 Batsman、Bowler、WK-Batsman 或 Batting Allrounder,便于按场上角色对阵容卡片分组。
队长、门将与海外球员布尔值 示例行以布尔值提供 captain、keeper、isoverseas 和 isheader,无需解析球员姓名或自由文本,就能直接绘制各类徽标。
针对单场比赛,而非整个赛事 阵容限定在所给的那一场比赛内,与系列赛范围的阵容数据不同。同一系列赛里,一支球队在每场比赛中派出的名单可能各不相同。
仅有示例结构,已明确标注 目前没有探测调用,唯一的依据是一份被截断的源示例,所以发布之前应对照真实响应核对字段名,以及经常为空的文本字段。

在线 API 演示

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

使用场景

常见问题

单场球队阵容接口返回什么内容?

按说明,它返回一场比赛中某一支球队的阵容。唯一的依据是一份被截断的源示例:其中有一个由类别分组构成的 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 都是空字符串,部分图片引用的值为零。请把它们当作可选字段,并在界面中做好兜底显示。

相关接口

相关指南

查看订阅方案 →