获取板球比赛的梦幻指南首页,含预测视频与各板块链接。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →获取单场板球比赛的梦幻指南落地页数据,即带有胜负预测和主要板块的指南首页。唯一输入是必填的数字型路径参数 matchId,可取自比赛列表、赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段,默认值为 151543。目前提供的探测记录中没有观察到该接口的实际响应,因此下文字段来自一份未经验证的源示例,仅作示意说明,不构成已验证的接口约定。示例包含比赛头部字段 id、title、subtitle、matchDesc、seriesName、seriesShortName、team1ShortName 和 team2ShortName;一个 tabs 数组,其条目带有 id、path 和 title,分别指向专家专区、对位分析、场地信息和全部球员等板块;以及一个对应“比赛预测”短片的 video 对象。示例中的 video 对象包含 id、title、description、durationStr、videoType、videoFormat、language、source、publishedTime、imageId、category、tags,以及把短片关联到系列赛、比赛、球队和球员的 tagItems。示例中没有数值型的胜率字段,因此请把任何预测视为数据源提供的内容,而不是经过校准的赔率或确定的结果。视频字段可能包含带签名的播放链接,该链接不应被保存或分享,能否返回数据取决于所选比赛的覆盖情况。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/fantasy-get-match-forecast API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/fantasy-get-match-forecast?key=<API_KEY>&matchId=151543'
查询结果
使用场景
- 为选定的比赛加载梦幻指南首页,并根据返回的 path 和 title 值搭建标签栏。
- 在赛前预览页上显示比赛预测短片卡片,包括标题、时长和简介,并标注其为数据源提供的预测。
- 使用同一个 matchId,把面向读者的标签页链接到专家专区、对位分析、场地信息和全部球员等接口。
- 利用标签中的球员和球队 itemId,在编辑工作流里把预测视频交叉链接到球员资料页和球队页。
- 在加入自己的分析之前,先用 title、matchDesc 和 seriesName 为赛事预览通讯预填标题和系列赛标签。
常见问题
我应该传哪个 matchId?
使用比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段。它是必填的数字型路径参数,默认值为 151543。
这个接口会返回胜率吗?
接口描述为带有胜负预测和主要板块的梦幻指南首页,但未经验证的源示例中并没有数值型的概率字段,只有头部数据、板块标签页和一个比赛预测视频。请不要把它当作经过校准的赔率或确定的结果来展示。
tabs 条目包含什么内容?
示例中的每个条目都有 id、path 和 title。其中的 path 为 expertCorner、matchUps、venueInfo 和 allPlayers,分别对应同一 matchId 下的其他梦幻研究接口。
video 对象描述了什么?
示例中它保存的是比赛预测短片的元数据,包括 title、description、durationStr、videoType、videoFormat、language、source、发布时间、图片 ID 和标签列表。短片链接可能带有临时的签名令牌,因此请不要保存或再分发。
这些字段是在探测中观察到的吗?
不是。该接口在提供的探测记录中没有观察到响应,所以这些字段只是来自源示例的示意说明,并非已验证的接口约定。
如果比赛暂时没有预测视频怎么办?
数据源说明通常先发布视频分析,文字预测随后补充,并且覆盖情况因比赛而异。文档没有说明缺失板块在响应中如何呈现,所以请在客户端中把视频和其他板块都当作可选内容处理。