按 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 用 name、fullName、role、bat、bowl、height 和 birthPlace 渲染球员页头部,并去掉部分值带有的尾随空格。
- 根据 rankings 对象在球员卡片上显示 Test、ODI 和 T20 的生涯最佳排名徽章,并隐藏所在部分为空对象的徽章。
- 用 teamNameIds 构建球队履历标签行,让每家俱乐部或国家队都能按 teamId 链接到球队页面。
- 动态读取 headers 和 rows,用 recentBatting 与 recentBowling 搭建近期状态面板;在确认开头的值如何对应比赛之后,再把每一行链接到比赛页面。
- 把 faceImageId 与 intlTeamImageId 传给图片接口取得头像和国家队图片,并与球员记录一起缓存。
- 按 HTML 换行标签拆分 bio 文本,生成赛前预览文章的段落,并保留自己的人工审校环节。
常见问题
这个接口的 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,避免凭空猜测。