按 playerId 获取单个板球球员资料:姓名、角色、击球与投球风格、出生信息、最佳排名、球队 ID 和近期状态

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

返回单个板球球员的资料。playerId 为必填的数字,放在 URL 路径中:请使用本产品的热门球员或球员搜索接口返回的 id 值。默认值 6635 只是示例。针对 playerId 6635 的一次实际探测返回了 HTTP 200 和一个 JSON 对象,观察到的字段有 id、name、fullName、role、bat(击球风格)、bowl(投球风格)、height、birthPlace、intlTeam、teams(以逗号分隔的球队名称字符串)、DoB、DoBFormat、image(URL 字符串)、bio、rankings、appIndex、faceImageId 和 intlTeamImageId(均为整数)、teamNameIds(由 teamId 和 teamName 对象组成的数组)、playerTeamIds(以逗号分隔的球队 ID 字符串),以及 recentBatting 和 recentBowling 两个对象,每个对象都包含 headers 数组和 rows 数组。在该次探测中,rankings.bat 包含字符串形式的 testBestRank、odiBestRank 和 t20BestRank,而 rankings.bowl 和 rankings.all 是空对象。部分文本值带有尾随空格,DoB 在括号中包含年龄,bio 含有 HTML 换行标签。探测中 recentBatting 的每一行有五个值而表头只有四个,开头的值看起来是比赛标识,followUpLinkText 则保存相对页面路径。源 200 示例在 bio 内部被截断,因此其后的字段只能依据探测结果得知。字段取决于数据覆盖情况,球员的排名或近期状态部分可能为空。

API 功能

一次请求取得资料字段 只需一次 playerId 请求,就能得到 name、fullName、role、bat、bowl、height、birthPlace 和 intlTeam 字段,足够填充球员页头部,无需拼接多个数据源。
两种出生日期格式 DoB 带有括号中的年龄,DoBFormat 则是纯日期,可以展示易读文本,也可以直接解析干净的日期值,不必自己去掉年龄。
最佳排名汇总对象 rankings 对象分为 bat、bowl 和 all 三部分;探测中的击球部分以字符串给出 Test、ODI 和 T20 的最佳排名,球员卡片可以显示生涯最佳排名并隐藏空的部分。
球队 ID 关联 teamNameIds 把每个 teamId 与 teamName 配对,playerTeamIds 则以逗号分隔字符串重复这些 ID,可以直接用标识符跳转球队页面,而不用按名称文本去匹配。
近期击球与投球表格 recentBatting 与 recentBowling 都返回 headers 和 rows,并带有 followUpLinkText 页面路径,球员页无需先调用比赛接口就能展示最近状态表。
头像图片标识符 faceImageId 与 intlTeamImageId 是整数,可以传给本产品的图片接口,用 ID 展示球员头像和国家队徽标。
生涯叙述性简介文本 bio 字段是较长的生涯概述,段落之间用 HTML 换行标签分隔,把换行转换成自己的段落标记后,很适合放进“关于球员”板块。

在线 API 演示

GET /api/project/cricbuzz-cricket/players-get-info

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

这个接口的 playerId 从哪里获取?

使用本产品的热门球员或球员搜索接口返回的 id 值。那些接口以数字字符串的形式返回它,而本接口把 playerId 声明为 URL 路径中的必填数字。默认值 6635 只是示例。

实际观察到了哪些响应字段?

针对 playerId 6635 的探测返回了 HTTP 200,字段包括 id、name、fullName、role、bat、bowl、height、birthPlace、intlTeam、teams、DoB、DoBFormat、image、bio、rankings、appIndex、faceImageId、intlTeamImageId、teamNameIds、playerTeamIds、recentBatting 和 recentBowling。源示例在 bio 内部被截断,所以请以探测结果作为字段参考。

为什么 rankings.bowl 和 rankings.all 是空的?

在默认球员的探测中,rankings.bat 包含 testBestRank、odiBestRank 和 t20BestRank,而 bowl 和 all 是空对象。空对象表示该部分没有返回排名数据,不代表排名为零。

应该保存哪个出生日期字段?

建议保存 DoBFormat,它是纯日期文本。DoB 带有括号中的年龄,而这个年龄只在生成响应的那一刻是准确的,保存下来之后会过期。

为什么 recentBatting 的行比表头多一个值?

探测中每一行有五个值,而表头只有四个(Score、OPPN.、Format、Date)。开头的值看起来是比赛标识,followUpLinkText 则保存页面路径。请先用自己的样本验证这种对应关系,再据此生成链接。

teamNameIds 和 playerTeamIds 有什么用?

teamNameIds 是由 teamId 和 teamName 组成的对象数组,playerTeamIds 则是同一组球队 ID 的逗号分隔字符串。可以用这些 ID 跳转到本产品的球队数据,名称则用于展示。

bio 字段是纯文本吗?

不是。bio 的段落之间含有 HTML 换行标签,在纯文本视图中展示之前请先转换或去掉,也不要未经清洗就把它当作原始 HTML 插入页面。

传入未知的 playerId 会怎样?

现有证据只记录了成功响应,没有针对无效 ID 的探测。请在客户端处理非 200 响应和空的部分,并从热门球员或搜索接口获取 ID,避免凭空猜测。

相关接口

相关指南

查看订阅方案 →