按比赛 ID 获取单场板球比赛的实时比分面板

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

返回单场板球比赛的实时比分数据,由必填的数字型路径参数 `matchId` 指定(默认值 41881)。matchId 可从比赛列表、赛程、系列赛、球队和场地的比赛接口中获得。本接口没有记录过实时调用,所以下列字段来自源响应示例,均未经验证。示例是一场已结束的 U19 一日国际赛,因此展示的是最终状态而不是进行中的比分。响应包含一个存放最新一条解说的 `comwrapper` 数组(commtxt、eventtype、overnum、ballnbr、inningsid、timestamp 以及 commentaryformats 列表)、一个 inningsid、一个空的 `matchvideos` 数组,以及一个 `miniscore` 对象。miniscore 带有当前击球手(batsmanstriker、batsmannonstriker)和投球手(bowlerstriker、bowlernonstriker)的得分、球数、回合数、出局数和经济率,还有 `batteamscore`(teamid、teamscore、teamwkts)、crr、rrr、target、ballsrem、oversrem、custstatus、event、lastwkt、partnership、一个 `performance` 列表(例如最近 5 回合和最近 10 回合)、一个 `pp` 强力击球期区块、一个 `inningsscores` 列表(每局的 runs、wickets、overs、balls、target、isdeclared、isfollowon)以及一个 timestamp。顶层和 miniscore 内部各有一个 responselastupdated 字段,两者取值不同,其单位没有文档说明。本接口是聚焦的比分面板,不是完整的击球与投球记分卡。

API 功能

聚焦的单场比分面板 针对选定的 matchId,一次请求同时返回比分快照和最新的一条解说,所以比分组件不需要拉取整份实时比赛列表。
comwrapper 中的最新解说 comwrapper 数组保存最近一条记录,带有 commtxt、eventtype(示例中为 WICKET)、overnum、ballnbr 和 timestamp,可以驱动比分下方的“最近一球”行。
当前击球手与投球手 miniscore 列出场上的击球手和非击球手,带有得分、球数、四分球、六分球和击球率;两名投球手则带有回合数、失分、出局数和经济率,如示例所示。
追分字段:目标分与跑率 miniscore 中的 target、crr、rrr、ballsrem 和 oversrem 可用于追分追踪器,但需要先核对你所服务的比赛状态下哪些字段有值。
最近出局与搭档文本 lastwkt 保存一行出局描述,包含出局时的比分和回合数,partnership 保存当前搭档情况,适合做简短的局势横幅。
强力击球期与近期回合区块 pp 区块列出强力击球期类型、回合范围、得分和出局数,performance 列表在示例中给出最近 5 回合和最近 10 回合带标签的得分与出局数。
按局划分的比分条目 inningsscores 给出每一局的 runs、wickets、overs、balls、target 以及宣布结束和 follow-on 标志,所以同一份响应就能画出结果中双方的比分。

在线 API 演示

GET /api/project/cricbuzz-cricket/match-details-get-livescore

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

需要哪些参数?

只需要 URL 路径中的数字型 matchId。可从比赛列表、赛程、系列赛、球队赛程与结果,以及场地比赛接口中取得。默认值 41881 是一场已结束的 U19 一日国际赛小组赛的示例标识。

响应经过实时调用验证吗?

没有。没有记录过实时调用,所以字段列表来自一场已结束比赛的源响应示例。在此基础上开发之前,请核对真实响应中的字段名称和值类型,最好选择一场正在进行的比赛。

实时比分与 leanback、记分卡接口有何不同?

实时比分返回当前比分快照以及最新一条解说。leanback 接口额外提供含抛币和奖项列表的比赛页头,记分卡接口则返回完整的击球和投球表格。请选择与你要构建的页面相匹配的那一个。

它会返回该局所有的击球手和投球手吗?

不会。示例只在 miniscore 中展示了当前击球手、非击球手和两名投球手,外加一条解说。要获取全部击球记录和出局信息,请对同一个 matchId 使用记分卡接口。

应该多久轮询一次?

刷新节奏没有文档说明,也没有通过实时调用测量过。请先从保守的间隔开始,对比各次响应之间的 timestamp 值,并在观察真实的进行中比赛之后再调整。

为什么示例里 overs 是 49.6?

示例中某一局的 overs 为 49.6,balls 为 300,也就是整整 50 回合。需要精确运算时请使用 balls,把 overs 当作显示用字符串。

两个 responselastupdated 值分别是什么意思?

示例中顶层的 responselastupdated 为 0,而 miniscore 内部是一个十位数字。它们的单位和含义没有文档说明,所以在核对真实响应之前,不要把它们用于新鲜度判断。

相关接口

相关指南

查看订阅方案 →