按比赛 ID 获取板球比赛中心快捷入口
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →根据必填的数字路径参数 `matchId`(默认 41881)返回一场板球比赛的比赛中心快捷入口。matchId 可从比赛列表、赛程、系列赛、球队赛程与赛果以及场馆比赛等接口获取。该接口没有查询参数,一次请求返回一份针对该场比赛的快捷入口列表。该接口没有留存探测调用记录,下列字段来自源响应示例,尚未经过实测验证;示例看起来是完整的,对应 matchId 为 41881 的 2021 年 ACC U19 亚洲杯比赛。响应是一个对象,其中的 `items` 数组在示例中有四个条目:Graphs、Table、Schedule 和 Series Stats。每个条目包含 name(显示名称)、iconName(以逗号分隔的图标别名列表,例如 'graph-nodes, graph_nodes')、showToPaidUsers(示例中四个条目均为 true)和 url。其中一个条目还带有 highlightType,在示例中是空字符串。url 的值是使用自定义协议的应用式深度链接,而不是 https 地址。Graphs 链接带有比赛 id 和值为 graphs 的 page,其余三个链接则带有系列赛 id(示例中为 3926)、page 值(points、schedule、stats)以及系列赛名称的 slug。showToPaidUsers 和 highlightType 的含义没有文档说明,其他比赛也可能出现别的 page 值。该接口只返回导航元数据:不包含比分、比分卡、解说或任何统计数据本身。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-quick-access API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-quick-access?key=<API_KEY>&matchId=41881'
查询结果
使用场景
- 利用返回的快捷入口信息搭建比赛中心快捷菜单,并用返回的 name 作为每个按钮的标签。
- 让导航上下文随比赛变化,而不是为每场比赛都硬编码同一组快捷入口。
- 从返回的链接中提取系列赛 id 和名称 slug,在你只知道 matchId 的情况下打开对应的系列赛页面。
- 把 page 值(graphs、points、schedule、stats)转换为你应用中的路由,或转换为对相应数据接口的调用。
- 在设计固定导航栏之前,比较多场比赛的快捷入口集合,了解各场比赛分别开放哪些目的地。
常见问题
快捷入口接口返回什么内容?
在未经验证的源示例中,它是一个包含 items 数组的对象。每个条目都有 name、iconName、showToPaidUsers 标记和 url,其中一个条目还带有 highlightType。示例列出四个快捷入口:Graphs、Table、Schedule 和 Series Stats。
哪个参数是必填的,matchId 从哪里获取?
只有数字路径参数 matchId 是必填项(默认 41881)。可使用比赛列表、赛程、系列赛比赛、球队赛程与赛果以及场馆比赛等接口返回的 matchId。
这个响应经过探测调用验证了吗?
没有。该接口没有留存探测调用记录。字段来自 matchId 为 41881 的源示例,请针对你实际使用的比赛,对照真实响应确认字段名和取值。
url 的值是普通网页链接吗?
在示例中它们是使用自定义应用协议的深度链接,而不是 https 地址,所以浏览器无法直接打开。请解析其中的 id、page 和系列赛 slug,再映射到你自己的路由或相应的数据接口。
链接中会出现哪些 page 值?
示例中针对比赛的是 graphs,针对系列赛的是 points、schedule 和 stats。其他比赛或状态下可能还有别的取值,所以不要把这个列表当作完整清单。
showToPaidUsers 和 highlightType 是什么意思?
示例中四个条目的 showToPaidUsers 都是 true,其中一个条目的 highlightType 是空字符串。它们的语义没有文档说明,所以不要用它们来决定你自己内容的访问权限。
响应里包含比分或统计数据吗?
不包含。它只列出导航快捷入口。每个目的地背后的数据,请使用比分卡、解说、图表和系列赛等接口获取。
每场比赛返回的快捷入口都一样吗?
不保证一样。具体取决于比赛及其可用数据,items 列表可能为空或比示例更短。请根据实际返回的内容构建菜单,而不要假定一定有四个条目。