按比赛 ID 获取板球比分卡与击球手明细

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

根据必填的数字路径参数 `matchId`(默认 40381)返回一场板球比赛的比分卡。matchId 可从比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口获取。该接口没有查询参数,一次请求只对应一场比赛,无法按局数、球队或球员筛选。针对 matchId 40381 的探测调用返回了 HTTP 200 和一个 JSON 对象,其中包含 `scorecard` 数组、布尔值 `ismatchcomplete`、`appindex` 对象、字符串 `status` 以及整数 `responselastupdated`,声明的嵌套数值类型与实际一致,包括整数形式的 JSON 数字。所提供的源示例未经验证且被截断:其中 `appindex` 含有 `seotitle` 和 `weburl`,`scorecard` 条目含有 `ballnbr` 以及 `batsman` 列表,列表每行包含 `id`、`name`、`runs`、`balls`、`fours`、`sixes`、`strkrate`(字符串,例如 "154.55")、`outdec`(出局描述文字)、`iscaptain` 和 `iskeeper`。该示例中没有出现投球数据、额外得分和失分顺序等部分,依赖这些内容之前请先用真实响应确认。`responselastupdated` 的单位没有文档说明,不要自行推断。数据覆盖取决于比赛本身,尚未开始或被取消的比赛可能只返回内容很少的响应。

API 功能

一场比赛一次比分卡请求 只需一次携带 matchId 路径参数的 GET 请求,就能拿到该场比赛的比分卡,比赛页面不必再从多个数据源拼接结果。
探测确认的顶层结构 针对 matchId 40381 的真实探测返回 HTTP 200,包含 scorecard(数组)、ismatchcomplete(布尔值)、appindex(对象)、status(字符串)和 responselastupdated(整数),嵌套数值类型与声明的结构一致。
完赛标记加状态文字 布尔值 ismatchcomplete 与字符串 status 可帮助客户端判断是继续刷新进行中的比赛,还是把已结束的比赛固定下来。所提供的资料没有列出 status 的全部取值。
不透明的更新计数 整数 responselastupdated 可以和缓存的比分卡一起保存,并在两次请求之间比较。它的时间单位没有文档说明,只能当作变化标记使用,不要当作日历时间。
带出局描述的击球手明细 未经验证的源示例中,每位击球手都带有得分、球数、四分球、六分球、字符串形式的击球率以及 outdec 出局描述,等真实响应确认字段后,就足以绘制一张击球比分卡。
appindex 中的页面信息 源示例里的 appindex 对象包含 seotitle 和 weburl 两个字符串,可为比分卡页面提供标题和分享链接。请先确认你要展示的比赛是否都带有这两个键。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

比分卡接口返回什么内容?

它以 JSON 对象的形式返回一场比赛的比分卡。针对 matchId 40381 的探测调用确认了顶层键 scorecard(数组)、ismatchcomplete(布尔值)、appindex(对象)、status(字符串)和 responselastupdated(整数)。嵌套的击球字段来自被截断且未经验证的源示例,请对照真实响应核对。

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

只有数字路径参数 matchId 是必填项(默认 40381)。可使用比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口返回的 matchId。该接口不存在查询参数,所以没有按局数或球队筛选的功能。

哪些字段由探测调用确认,哪些只来自示例?

探测调用确认了五个顶层键及其类型。击球手层级的字段,例如 name、runs、balls、fours、sixes、strkrate 和 outdec,只出现在被截断的源示例中,在你自己的响应里看到之前,请视为未验证。

击球数据是数字还是字符串?

在源示例中,runs、balls、fours 和 sixes 是整数,而 strkrate 是字符串,例如 "100" 或 "154.55"。请有意识地解析击球率,不要默认它是数值类型,其他字段则按整数处理。

怎样判断一场比赛是否已经结束?

读取布尔值 ismatchcomplete,并同时展示字符串 status。所提供的资料没有列出 status 的可能取值,所以请按返回的原文显示,不要把它映射成固定的几种状态。

可以把 responselastupdated 转换成日期吗?

探测调用确认它是整数,但单位没有文档说明,所以不要假设它是秒或毫秒。请把它当作不透明的标记:比分卡刷新时它会变化,把它与你上次保存的值比较即可。

响应里包含投球数据或额外得分吗?

所提供的示例被截断,其中没有出现这些内容,因此本页面不承诺提供。请获取一场你关心的已结束比赛,检查 scorecard 条目,确认之后再开发投球或额外得分组件。

相关接口

相关指南

查看订阅方案 →