按比赛 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在比赛分析工具中按局展示搭档明细,每个击球方对应一组数据序列。
- 为编辑审阅准备搭档摘要,不必从图表数据响应中推断并不存在的逐球关联信息。
- 在赛后回顾中按 totalRuns 和 totalBalls 对搭档记录排序,突出每一局最大的一次搭档。
- 在球探或研究笔记中,通过 bat1Id 和 bat2Id 把每对击球手链接到球员资料页面。
- 起草比赛报告图表时,对比两支球队在不同击球顺位上搭档的构成方式。
常见问题
搭档图表接口返回什么内容?
在未经验证的源示例中,它是一个数组,每一局对应一个对象。每个对象包含击球球队(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 选择某一局。
每场比赛都会返回搭档数据吗?
不一定。数据覆盖取决于赛事和比赛状态,因此可能出现空数组或缺少某一局的情况。请让界面能够妥善处理这种情形。