获取单场板球比赛中某名球员的梦幻研究资料、标签和关键信息。
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 打开球员研究卡片。
- 把球员在单场比赛中的梦幻背景与全局个人传记、职业生涯统计页面分开展示。
- 在梦幻阵容搭建器中为选中的球员弹出底部摘要,显示角色、击球顺位和 keyInfo 要点。
- 为关注名单中的球员打上 In form 和 Ideal for Conditions 标签,并针对每个即将进行的 matchId 刷新资料。
- 根据 country、role 和 keyInfo 预填编辑用的球员备注,发布前再结合独立的统计查询补充数据。
常见问题
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 是简短的十六进制字符串,只应作为标识符使用,在核对梦幻比赛球员接口返回的图例之前,不要假定它有固定含义。
这是完整的职业生涯资料或积分预测吗?
不是。它只是带有角色、风格和简短备注的比赛背景研究资料。示例中带有一条免责声明,说明预测仅供参考,并可能随天气、伤病或球队组成而变化,而且没有积分预测字段。