获取一场板球比赛提供的赛前胜率预测,以带标签的文本值返回。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →获取为单场板球比赛提供的赛前胜率预测。唯一输入是必填的数字型路径参数 matchId,可取自比赛列表、赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段,默认值为 151543。该接口被说明为赛前胜负预测。目前提供的探测记录中没有观察到该接口的实际响应,下文字段来自一份源示例,仅作示意说明,不构成已验证的接口约定。示例 200 响应是一个对象,其中的 cbPrediction 对象包含两个字符串:label 是预测的标题(示例为 CB Prematch Forecast),value 是单行文本,在同一个字符串里写明被看好的一方及其获胜概率(示例为 IND Wins (80% Probability))。概率嵌在文本中,而不是拆成单独的数值字段。源文档还列出了一个 204 响应,示例响应体为空对象,说明没有提供预测的比赛可能返回无内容。该预测只是针对一场比赛的参考信息,并不代表准确率,也不是博彩赔率、梦幻积分预测或结果保证。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/fantasy-get-partner-predictions API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/fantasy-get-partner-predictions?key=<API_KEY>&matchId=151543'
查询结果
使用场景
- 把提供的合作方赛前预测放在独立面板中,与专家分析和梦幻指南分开展示。
- 为选定比赛建立人工复核用的预测资料记录,不虚构预测准确率、博彩赔率或结果保证。
- 在比赛中心页面的对阵标题下方加入赛前预览条,展示 label 和 value,并在响应为空时自动隐藏。
- 在首球开始前保存预测文本,用于编辑部归档,再在明确标注的赛后回顾中与最终结果对照。
- 在笔记本中从 value 文本里解析球队代码和百分比,绘制即将进行的比赛的预测分布,并稳妥地应对格式变化。
常见问题
matchId 应该传什么?
使用比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段。它是必填的数字型路径参数,默认值为 151543。
响应里包含哪些内容?
源示例是一个带有 cbPrediction 字段的对象,字段内含 label 字符串和 value 字符串,例如一个预测标题,以及一行写明被看好一方和获胜概率的文本。这是未经验证的源示例,请用自己的请求确认实际返回结构。
这些字段是在探测中观察到的吗?
不是。提供的探测记录中没有观察到该接口的响应,这些字段来自一份源示例,只是示意说明,并非已验证的接口约定。
获胜概率是数值字段吗?
示例中不是。球队和百分比都在同一个文本 value 里,所以需要数值的客户端必须稳妥地解析该字符串,并保留原始文本用于展示。
比赛没有预测时会怎样?
源文档列出了一个示例响应体为空对象的 204 响应。请让客户端把空响应或缺失的 cbPrediction 当作无数据状态,并显示中性的提示。
可以把它当作博彩赔率或保证的结果吗?
不可以。它只是针对一场比赛的赛前预测文本,响应中没有赔率、梦幻积分或准确率数据,所以不要把它描述成保证的结果,也不要当作投注建议。
它与场地和梦幻指南接口有什么区别?
该接口只返回提供的胜率预测文本。场地与球场研究、球员推荐和对位卡片来自其他梦幻接口,如果需要,请用同一个 matchId 去调用它们。