获取单场板球比赛中某名球员的梦幻研究资料、标签和关键信息。

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

获取某名球员在单场板球比赛中的梦幻研究资料。两个输入都是必填数字:playerId 放在路径中,取自梦幻比赛球员接口(/forecast/v1/allPlayers/{matchId})返回球员的 id 字段;matchId 放在查询参数中,取自比赛列表、赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId 字段。默认值为 playerId 8733 和 matchId 151543。目前提供的探测记录中没有观察到该接口的实际响应,因此下文字段来自一份未经验证的源示例,仅作示意说明,不构成已验证的接口约定。示例是一个单独的对象,包含 id、fullName、country、role、batStyle、bowlStyle、stockDelivery、battingPosition、battingRole、faceImageId,由 code 和 label 组成的 badges 数组(例如 In form 和 Ideal for Conditions),由简短球探式句子组成的 keyInfo 数组,以及包含说明性备注的 disclaimer 数组。示例中该球员是击球手,bowlStyle 和 stockDelivery 为空字符串,因此请把投球相关字段视为可选。该资料是结合比赛背景的梦幻研究信息,并不是完整的个人传记、职业生涯统计页、预测的梦幻积分总数或已确认的出场名单,能否返回数据取决于所选比赛的覆盖情况。

API 功能

单场比赛内的球员资料 传入 playerId 和 matchId 一次调用,就能获得该球员在某场比赛背景下的研究资料,因此同一名球员在不同比赛中可以呈现出不同的内容。
角色与击球顺序字段 role、battingPosition 和 battingRole 描述球员预期承担的位置和作用,示例值包括 WK-Batter、Middle Order 和 Innings controller。
可能为空的风格字段 batStyle、bowlStyle 和 stockDelivery 描述球员的技术风格,示例中击球手的两个投球字段为空字符串,客户端可以直接隐藏而不是显示空白。
keyInfo 中的球探式短句 keyInfo 是一组简短的纯文本句子,例如针对快速球和旋转球的强弱项,可以作为球员卡片上的要点列表或提示气泡展示。
带显示文案的标签代码 badges 数组把简短的 code 与 In form、Ideal for Conditions 等 label 配成一对,你可以用 label 渲染标签小块,并把 code 保留为标识符。
身份与头像引用 id、fullName、country 和 faceImageId 用来标识球员并提供头像引用,足够给卡片拟定标题,也方便跳转到其他球员查询接口。

在线 API 演示

GET /api/project/cricbuzz-cricket/fantasy-get-player-info

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/fantasy-get-player-info?key=<API_KEY>&playerId=8733&matchId=151543'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

playerId 和 matchId 从哪里获取?

playerId 取自梦幻比赛球员响应中球员的 id 字段,matchId 取自比赛列表、赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口。两者都是必填数字,默认值分别为 8733 和 151543。

为什么资料还需要 matchId?

该接口返回的是球员在某场比赛中的梦幻资料,所以查询参数 matchId 把结果限定在一场比赛内。同一个 playerId 搭配不同的 matchId,就能获得对应比赛的背景信息。

示例里展示了哪些字段?

一个单独的对象,包含 id、fullName、country、role、batStyle、bowlStyle、stockDelivery、battingPosition、battingRole、faceImageId、badges、keyInfo 和 disclaimer。badges 由 code 和 label 组成,keyInfo 与 disclaimer 是字符串数组。

这些字段是在探测中观察到的吗?

不是。提供的探测记录中没有观察到该接口的响应,这些字段来自一份未经验证的源示例,只是示意说明,并非已验证的接口约定。

投球相关字段一定有值吗?

示例中没有。击球手的 bowlStyle 和 stockDelivery 是空字符串,因此展示投球信息前请先检查是否为空,投球手或全能球员的内容预计会有所不同。

标签的 code 和 label 应该怎么用?

展示 label 即可,例如 In form 或 Ideal for Conditions。示例中的 code 是简短的十六进制字符串,只应作为标识符使用,在核对梦幻比赛球员接口返回的图例之前,不要假定它有固定含义。

这是完整的职业生涯资料或积分预测吗?

不是。它只是带有角色、风格和简短备注的比赛背景研究资料。示例中带有一条免责声明,说明预测仅供参考,并可能随天气、伤病或球队组成而变化,而且没有积分预测字段。

相关接口

相关指南

查看订阅方案 →