按比赛 ID 获取板球各局搭档图表数据

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

根据必填的数字路径参数 `matchId`(默认 41881)返回一场板球比赛每一局的搭档(partnership)图表数据。matchId 可从比赛列表、赛程、系列赛、球队赛程与赛果以及场馆比赛等接口获取。该接口没有查询参数,一次请求即返回整场比赛的搭档数据。该接口没有留存探测调用记录,下列字段来自源响应示例,尚未经过实测验证;示例本身被截断,内容是 2021 年 ACC U19 亚洲杯中阿富汗 U19 对阿联酋 U19 的一场 U19 一日国际赛(ODI)小组赛。顶层是一个数组,每一局对应一个对象,包含 batTeamId、batTeamName、batTeamShortName、inningsID 以及一个 `partnershipDataDTO` 列表。每条搭档记录带有两个击球手数据块:bat1Id、bat1Name、bat1Runs、bat1balls、bat1ImageID,以及 bat2Id、bat2Name、bat2Runs、bat2balls、bat2ImageID,外加这对搭档的合计 totalRuns 和 totalBalls。示例中有几处细节需要留意。第一局中所有 bat1balls 和 bat2balls 的值都是 0,而 totalBalls 并不是 0,第二局则有填好的每名击球手球数。部分记录的 totalRuns 可能高于 bat1Runs 与 bat2Runs 之和,因此不要假定两者相等。同一个图片 ID(182026)出现在许多不同球员身上,这说明它可能是通用值,而不是球员专属图片。示例记录中没有出现出局序号或出局时比分的字段。数据覆盖取决于赛事和比赛状态,因此可能出现空数组或缺少某一局的情况。

API 功能

每局一个条目 示例响应是按局分组的数组,每个元素都带有 batTeamId、batTeamName、batTeamShortName 和 inningsID,可以把击球方与它的搭档数据对应起来。
每行都有击球手组合 partnershipDataDTO 的每一行都用 bat1Id、bat1Name、bat1Runs、bat1balls 以及对应的 bat2 字段标出两名击球手,无需再次查询就能为一个搭档组合加上标注。
同一行内包含搭档合计 totalRuns 和 totalBalls 与各击球手的数据放在一起,可以直接按搭档合计的得分和球数绘制这一组合。
可用于关联其他数据的标识 batTeamId、bat1Id、bat2Id 以及 bat1ImageID、bat2ImageID 可作为键,关联目录中其他位置的球队、球员和图片查询。
单个 matchId 请求 只需要数字路径参数 matchId(默认 41881)。没有筛选或分页,一次调用即可覆盖该场比赛所有可用的局。
已说明的示例特殊情况 文档指出了第一局每名击球手球数为零、合计得分高于击球手得分之和以及图片 ID 重复使用等情况,便于你的解析器和界面提前应对。

在线 API 演示

GET /api/project/cricbuzz-cricket/match-details-get-partnership-graph

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-partnership-graph?key=<API_KEY>&matchId=41881'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

搭档图表接口返回什么内容?

在未经验证的源示例中,它是一个数组,每一局对应一个对象。每个对象包含击球球队(batTeamId、batTeamName、batTeamShortName)、inningsID,以及一个 partnershipDataDTO 列表,列表里是各击球手组合及其得分、球数和合计数据。

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

只有数字路径参数 matchId 是必填项(默认 41881)。可使用比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口返回的 matchId。

这个响应经过探测调用验证了吗?

没有。该接口没有留存探测调用记录。字段清单来自一场已完赛的 2021 年 ACC U19 亚洲杯比赛的截断源示例,请对照真实响应确认字段名和类型。

为什么示例中第一局的 bat1balls 和 bat2balls 都是 0?

示例中第一局每名击球手的球数都是 0,而 totalBalls 为正数,但第二局有真实数值。这是否属于数据缺失没有文档说明,所以请以 totalBalls 作为搭档的持续球数,把每名击球手的球数视为可选信息。

为什么 totalRuns 可能高于两名击球手得分之和?

部分示例记录中 totalRuns 高于 bat1Runs 加 bat2Runs,例如两人得分分别为 3 和 0,而合计为 4。原因没有文档说明,所以不要假定搭档合计等于两名击球手数据之和。

能判断某次搭档属于第几个出局吗?

示例记录中没有出局序号或出局时比分的字段。记录是按顺序排列的,但文档并未保证这一顺序,所以在据此推导出局位置之前,请先在你自己的比赛数据上验证。

可以只请求某一局或筛选击球手组合吗?

不可以。该接口只接受 matchId,没有查询参数。收到数组后,请在客户端通过 inningsID 选择某一局。

每场比赛都会返回搭档数据吗?

不一定。数据覆盖取决于赛事和比赛状态,因此可能出现空数组或缺少某一局的情况。请让界面能够妥善处理这种情形。

相关接口

相关指南

查看订阅方案 →