按比赛 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在比赛中心里渲染比分卡标签页:遍历 scorecard 数组,并根据 ismatchcomplete 决定页面是否继续轮询。
- 构建保留类型的比分卡适配器并编写解析测试,保证布尔值、整数和字符串击球率都不被改写;空数据和多局比赛请使用明确标注的合成测试数据。
- 把每份比分卡与其 responselastupdated 值一起缓存,这样后台任务在计数没有变化时就可以跳过重复渲染。
- 为通过系列赛比赛或球队赛果接口找到的已结束比赛自动生成赛后摘要,列出每位击球手的得分、球数、四分球、六分球和出局描述。
- 把每位击球手的数据导入电子表格或分析笔记本,在发布赛后回顾文章之前做编辑核对。
常见问题
比分卡接口返回什么内容?
它以 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 条目,确认之后再开发投球或额外得分组件。