按比赛 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在发现比赛之后维护选定比赛的比分面板,而不必反复下载整份实时比赛列表。
- 把聚焦的实时比分组件与完整的击球和投球记分卡视图分开,并在制定轮询策略之前先确认刷新节奏。
- 用 lastwkt 和 partnership 在比分下方渲染最近出局与搭档横幅,两个字符串都为空时隐藏。
- 绘制追分追踪器,把击球方比分与 target 和所需跑率对比,并用 ballsrem 做精确运算。
- 在比赛详情页用 pp 和 performance 区块展示精简的强力击球期与最近回合表格。
- 重绘组件之前,对比两次请求之间的 timestamp 值,前提是先核实它在进行中的比赛里是如何推进的。
常见问题
需要哪些参数?
只需要 URL 路径中的数字型 matchId。可从比赛列表、赛程、系列赛、球队赛程与结果,以及场地比赛接口中取得。默认值 41881 是一场已结束的 U19 一日国际赛小组赛的示例标识。
响应经过实时调用验证吗?
没有。没有记录过实时调用,所以字段列表来自一场已结束比赛的源响应示例。在此基础上开发之前,请核对真实响应中的字段名称和值类型,最好选择一场正在进行的比赛。
实时比分与 leanback、记分卡接口有何不同?
实时比分返回当前比分快照以及最新一条解说。leanback 接口额外提供含抛币和奖项列表的比赛页头,记分卡接口则返回完整的击球和投球表格。请选择与你要构建的页面相匹配的那一个。
它会返回该局所有的击球手和投球手吗?
不会。示例只在 miniscore 中展示了当前击球手、非击球手和两名投球手,外加一条解说。要获取全部击球记录和出局信息,请对同一个 matchId 使用记分卡接口。
应该多久轮询一次?
刷新节奏没有文档说明,也没有通过实时调用测量过。请先从保守的间隔开始,对比各次响应之间的 timestamp 值,并在观察真实的进行中比赛之后再调整。
为什么示例里 overs 是 49.6?
示例中某一局的 overs 为 49.6,balls 为 300,也就是整整 50 回合。需要精确运算时请使用 balls,把 overs 当作显示用字符串。
两个 responselastupdated 值分别是什么意思?
示例中顶层的 responselastupdated 为 0,而 miniscore 内部是一个十位数字。它们的单位和含义没有文档说明,所以在核对真实响应之前,不要把它们用于新鲜度判断。