列出即将开赛的板球比赛及赛前预测文字,无内容时返回空结果。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →获取梦幻预测中心,即一份带有赛前预测信息的即将开赛板球比赛列表。该接口不需要任何参数。目录备注显示,测试时它返回过 HTTP 204(无内容),因此调用可能得到空响应体,客户端应把这视为无内容状态,而不是错误或长期不可用。提供的探测记录中没有观察到响应体。下文字段来自归在 204 状态下的一份未经验证的源示例,仅作示意说明,不构成已验证的接口约定。示例包含一个 matches 数组,每个条目带有 matchId、matchName、matchFormat、state、startdt、customStatus、seriesId、seriesName 和 seriesCategory,以及包含 id、name、shortName、imageId 和 color 的 team1 与 team2 对象。示例还展示了带有 label 和 text 的 cbPrediction 对象、isForecastEnabled 与 isProbabilityEnabled 两个开关、fillerText 提示信息、highlightedTeamId,以及 forecastUrl 和 livePredictionUrl 两个链接字段,它们看起来是应用内深度链接,而不是网页地址。预测文字是编辑撰写的预测内容,并不是经过校准的博彩赔率或保证的结果,具体出现哪些比赛取决于覆盖情况。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/fantasy-get-prediction-hub 无需参数,点击查询即可调用 API。
API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/fantasy-get-prediction-hub?key=<API_KEY>'
查询结果
使用场景
- 只有在预测中心确实返回内容时,才展示即将开赛比赛的预测发现页面。
- 为目录中记录的 HTTP 204 结果实现无内容状态,避免用虚构预测来替代,也不要把它理解为长期不可用。
- 用比赛名称、赛制和开赛日期填充比赛轮播,再用每个 matchId 打开单场比赛的梦幻研究接口。
- 根据 team1 和 team2 的 shortName 与 color 字段,为赛前文章侧边栏里的球队标签设置样式。
- 运行定时检查,记录预测中心返回的是有内容还是无内容,以了解你关注的赛事有多少时候能拿到预测。
常见问题
这个接口需要参数吗?
不需要。路径是固定的,没有路径、查询或请求头输入需要设置,直接发起一次普通的 GET 请求即可。
为什么响应可能为空?
目录备注显示该接口在测试时返回过 HTTP 204。204 没有响应体,请把它当作无内容状态处理。文档没有说明这是否只是暂时现象,所以不要假定它是长期不可用。
示例里展示了哪些字段?
一个 matches 数组,条目中包含比赛、系列赛和球队字段,还有带 label 和 text 的 cbPrediction 对象、启用开关、fillerText 提示信息、highlightedTeamId 以及两个预测链接字段。
这些字段是在探测中观察到的吗?
不是。提供的探测记录中没有观察到响应体,示例在源文档中归在 204 状态下,所以请把这些字段视为未经验证的示意,等预测中心返回内容时再确认真实结构。
预测是博彩赔率或保证的结果吗?
不是。示例中的预测是带有概率措辞的简短编辑文字,并非经过校准的赔率。请把它作为参考性预测来展示,不要描述为保证的结果。
如何获取某场列出比赛的更多详情?
把条目中的 matchId 复用到其他梦幻研究接口,例如比赛球员列表、对位数据、专家专区或比赛预测,这些接口都接受 matchId。
可以在浏览器中打开 forecastUrl 吗?
这些链接字段看起来是应用内深度链接,而不是网页地址,所以不要假定它们能在浏览器中打开。请改为根据 matchId 自行构建导航。