按 playerId 获取板球球员的击球统计(赛制 × 指标表格),可用 seriesId 限定为某一系列赛
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →以表格形式返回单个板球球员的击球统计。playerId 为必填的数字,放在 URL 路径中:请使用本产品的热门球员或球员搜索接口返回的 id 值。默认值 8733 只是示例。seriesId 为可选的数字,放在查询字符串中:传入系列赛列表或系列赛归档接口返回的系列赛 id,可把统计限定在该系列赛内;留空则使用默认视图。源 200 示例是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)、headers 数组(示例中为 ROWHEADER、Test、ODI、T20 和 IPL)、由 seriesName 对象组成的 seriesSpinner 数组(示例中只有一个 Career 条目),以及 values 数组。values 的每个元素都是一个带有自己 values 字符串数组的对象:第一个字符串是指标名称,后面的字符串与 headers 中的赛制列一一对应。示例中的指标有 Matches、Innings、Runs、Balls、Highest、Average、SR、Not Out、Fours、Sixes、Ducks、50s、100s、200s、300s 和 400s,所有数字都是字符串。该接口没有记录过实际探测调用,因此所有字段都来自源示例。列、系列赛选项以及传入 seriesId 后的默认行为均未经验证,也不保证覆盖完整的生涯数据。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/players-get-batting API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/players-get-batting?key=<API_KEY>&playerId=8733'
查询结果
使用场景
- 在球员页上搭建击球统计页签:headers 中每一项对应一列,values 中每个指标名称对应一行。
- 对同一个 playerId 分别不带 seriesId 和带上系列赛 id 各请求一次,对比生涯数据和赛事数据,并在检查两次响应的结构后再并排展示两张表。
- 把 values 各行转成“指标 × 赛制”的对象,为球探笔记快速比较 Test、ODI 和 T20 的平均分与打击率。
- 为球员的候选名单(可通过热门球员列表找到)在梦幻板球研究表里填入 Runs、Average 和 SR,仅作为背景统计,不当作积分或预测。
- 为“本周最佳球员”专题搭建里程碑卡片,展示各赛制的 50s 和 100s 数量,并隐藏 headers 中不存在的列。
常见问题
击球统计接口会返回什么?
返回一个表格式对象:appIndex 对象、赛制列的 headers 数组、seriesSpinner 数组以及 values 行数组。每一行自己的 values 数组以指标名称开头,后面是每列一个字符串。该接口没有记录过实际探测调用,所以这些字段来自源示例。
playerId 从哪里获取?
使用本产品的热门球员或球员搜索接口返回的 id 值。它们以数字字符串形式返回,而本接口把 playerId 声明为 URL 路径中的必填数字。默认值 8733 对应源示例中的球员,只是示例值。
seriesId 有什么作用,在哪里找到它?
seriesId 为可选参数,用于把统计限定在某一系列赛内。可以从本产品的系列赛列表或系列赛归档接口获取它的 id,源文档给出 7607 对应 IPL 2024。指定系列赛后的响应是什么样子没有探测记录,所以请对每个请求的系列赛检查 headers 和 values。
为什么所有数字都是字符串?
在源示例中,包括 Runs、Average 和 SR 在内的所有值都是字符串。请在客户端自行解析;如果需要保留数据源的四舍五入方式,可以保留原始文本。
列是否总是 Test、ODI、T20 和 IPL?
示例在 ROWHEADER 之后展示了这四列,但其他球员或系列赛的列并没有文档说明。请在每次响应中读取 headers,并按位置把每个指标行与列对应起来,不要写死赛制名称。
seriesSpinner 字段是什么?
它是由 seriesName 对象组成的数组,源示例中只有一个 Career 条目。它在按系列赛查询时的含义尚未验证,在用它构建选择器之前,请先检查自己的响应。
这能覆盖球员的完整生涯吗?
不一定。覆盖范围取决于数据源,现有证据也不保证完整的生涯记录或特定赛事。在把表格当作完整生涯总结展示之前,请先检查返回的 Matches 和 Innings 行。
appIndex 字段有什么用?
appIndex 含有 seoTitle 和 webURL 字符串,用来描述该球员在数据源中的页面。它们是响应的元数据而不是统计数据,所以不要混入击球统计表。