按 playerId 获取板球球员投球统计表,含 Test、ODI、T20 与 IPL 各赛制列,可选 seriesId 系列赛筛选
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →以表格形式返回单个球员的投球统计。playerId 通过 URL 路径传入(必填数字,默认值 8733 是文档中的示例值),seriesId 可作为查询参数选填,用于把统计限定在某一个系列赛。源文档中的 200 示例是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)、headers 数组(ROWHEADER、Test、ODI、T20、IPL)、seriesSpinner 数组(只有一个条目,其 seriesName 为 Career)以及 values 数组。values 的每个元素本身又是一个带有 values 字符串数组的对象:第一个字符串是行标签,其后的字符串与 headers 中 ROWHEADER 之后的列一一对应。示例中的行包括 Matches、Innings、Balls、Runs、Maidens、Wickets、Avg、Eco、SR、BBI、BBM、4w、5w 和 10w。所有数值都以字符串形式返回;没有投球局数的球员会显示 0、0.0 或 -/- 占位值,默认 ID 的示例就是如此(Test 列有 70 场比赛,但投球局数为 0)。该接口没有记录过实际探测调用,因此这里描述的所有响应字段都来自源示例,并未经过独立验证。设置 seriesId 后表格和 seriesSpinner 条目会如何变化,所提供的资料中没有说明,不同球员和系列赛的数据覆盖也可能不同。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/players-get-bowling API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/players-get-bowling?key=<API_KEY>&playerId=8733'
查询结果
使用场景
- 填充球员资料页的投球标签:用 headers 数组和以标签开头的行搭出 Test、ODI、T20、IPL 四列表格。
- 识别阵容中真正投过球的球员:读取 Innings 和 Wickets 行,因为源示例里有球员出场多场但投球局数为 0。
- 生成某个系列赛的投球卡片:传入从系列赛列表或归档接口取得的 seriesId,再与同一球员不带筛选的视图对比。
- 在自己的代码中把 Eco 和 SR 字符串转为数字后,为两名投手绘制跨赛制的经济率与 SR 对比图。
- 撰写赛前前瞻稿:引用投手的三柱门数、经济率和单场五个三柱门(5w)次数,并避免把 -/- 这类最佳成绩占位值写进文案。
常见问题
球员投球统计接口会返回什么?
根据源 200 示例,返回 appIndex 对象、headers 数组、seriesSpinner 数组以及由投球行组成的 values 数组。每一行是一个带有字符串数组 values 的对象:先是行标签,然后每个赛制列一个数值。该接口没有记录过实际探测调用,所以这些字段来自源示例,并未经过独立验证。
它接受哪些参数?
playerId 必填,以数字形式放在 URL 路径中,默认值为 8733;seriesId 选填,以数字形式放在查询字符串中,用于把统计限定在某个系列赛。文档中没有其他参数。
playerId 和 seriesId 从哪里获取?
playerId 取自热门球员或球员搜索接口返回的 id 字段,seriesId 取自系列赛列表或系列赛归档接口返回的 id 字段。两者都是纯数字标识符;参数说明中给出 IPL 2024 的 id 为 7607。
如何读取 headers 和 values 数组?
headers 列出各列名称,示例中先是 ROWHEADER,然后是 Test、ODI、T20 和 IPL。values 的每个条目里,第一个字符串是行标签,其后的字符串按相同顺序对应各赛制列,所以同一行内按位置对齐,行本身则按标签查找。
为什么示例里大多数数值是 0?
默认 playerId 的示例对应一名出场多场但投球局数为 0 的球员,因此投球行里是 0、0.0 和 -/- 占位值。任何没投过球的球员都可能出现同样的占位值,不要把它们当作实测平均数。
数值是数字还是字符串?
是字符串。Matches、Wickets、Avg、Eco、SR 等所有行都以文本形式返回,最佳投球成绩行还可能是 -/-。在排序或求平均之前,请先在自己的代码中显式解析,并决定如何处理占位值。
设置 seriesId 后响应会有什么变化?
参数文档只说明它会把统计限定在某个系列赛。所提供的资料没有显示设置后 headers、行或 seriesSpinner 条目有什么不同,所以在基于它开发功能之前,请用自己的系列赛分别发一次带筛选和不带筛选的请求并对比。
这个接口包含击球数据或生涯日期吗?
不包含。它只返回投球表。击球数据请使用击球统计接口,首秀和最近一次出场信息请使用生涯接口。