按 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 功能

四种赛制并排的投球表 headers 数组列出 Test、ODI、T20 和 IPL 各列,一次 GET 请求就能并排拿到所有已列赛制的投球数据,不必按赛制分别发请求。
以标签开头的统计行 values 中的每一行都以标签(Matches、Wickets、Eco 等)开头,后面跟着每个赛制一列的字符串,客户端可以按标签查找行,不依赖行的位置。
可选的系列赛筛选 seriesId 查询参数可把统计限定在某个系列赛,例如参数说明中给出的 IPL 2024 对应 id 7607;不传该参数则保持默认视图。
响应内自带系列赛选择器 响应包含 seriesSpinner 数组,源示例中只有一个 Career 条目,客户端可以据此告诉用户当前表格描述的是哪个统计范围。
十四项投球指标 示例行覆盖场次、投球局数、投球数、失分、无失分局、三柱门数、平均失分、经济率、SR(每个三柱门所需投球数)、最佳投球成绩(BBI 和 BBM)以及 4w、5w、10w 次数。
字符串数值与占位符 所有数字都以字符串返回,没有投球记录时使用 0、0.0 或 -/- 作为占位值,所以需要显式转换,并把占位值当作“暂无数据”而不是实测结果。
投球数据独立成表 该接口只返回投球表,球员资料页可以在打开投球标签时再请求它,击球数据和生涯数据则通过各自的接口获取。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

球员投球统计接口会返回什么?

根据源 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 条目有什么不同,所以在基于它开发功能之前,请用自己的系列赛分别发一次带筛选和不带筛选的请求并对比。

这个接口包含击球数据或生涯日期吗?

不包含。它只返回投球表。击球数据请使用击球统计接口,首秀和最近一次出场信息请使用生涯接口。

相关接口

相关指南

查看订阅方案 →