按 seriesId 和 statsType 获取板球系列赛统计榜单,默认 mostRuns 表,返回表头数组与球员数据行
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回单个板球系列赛的统计榜单。seriesId 放在 URL 路径中(必填数字,默认值 3718 为文档示例值),statsType 作为必填查询字符串传入(默认值 mostRuns 为文档示例值)。这两个值都来自本产品的其他接口:seriesId 是系列赛列表或系列赛归档接口返回的 id 字段,statsType 是系列赛统计筛选接口返回的 value 字段。源文档中的 200 示例是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)、filter 对象(其 matchtype 数组列出 matchTypeDesc 和 matchTypeId 字符串,示例中只有一条 Test 记录),以及带有 headers 数组(Batter、M、I、R、SR)和 values 数组的 testStatsList 对象。values 中的每个元素都是一个对象,内含自己的 values 字符串数组:示例里第一个字符串看起来是球员数字 id,第二个是球员姓名,后面的字符串与 Batter 表头之后的各列依次对应,因此每一行比 headers 多一个字符串。示例列出了 Plunket Shield 2021-22 系列赛的十五行数据。该接口没有记录过实时探测,这里描述的所有响应字段均来自源示例,未经独立验证。现有证据没有说明其他 statsType 取值下列表对象、表头和 matchtype 筛选会如何变化,且覆盖范围取决于具体系列赛。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/series-get-stats API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-get-stats?key=<API_KEY>&seriesId=3718&statsType=mostRuns'
查询结果
使用场景
- 根据默认 mostRuns 表的 headers 数组和球员数据行,为国内赛事页面制作最多跑分球员排行榜。
- 先调用系列赛统计筛选接口填充统计类型下拉框,再用同一个 seriesId 逐个请求每个 statsType 取值。
- 取每一行开头的 id 字符串,对照球员搜索或系列赛球员结果核对后,把榜单每一行链接到球员资料页。
- 导出数据时把 seriesId 与每一行一同保存,让 Plunket Shield 2021-22 的数据不会和其他赛季的榜单混在一起。
- 撰写赛事中期的编辑点评,引用跑分和打击率排名前三的击球手,并先在自己的代码中把字符串数值转换为数字。
常见问题
系列赛统计接口返回什么内容?
根据源文档的 200 示例,它返回 appIndex 对象、带 matchtype 数组的 filter 对象,以及由 headers 数组和球员行 values 数组组成的统计列表(示例中为 testStatsList)。该接口没有记录过实时探测,这些字段均来自源示例,未经独立验证。
它接受哪些参数?
seriesId 必填,放在 URL 路径中,类型为数字,默认值为 3718;statsType 必填,放在查询字符串中,类型为字符串,默认值为 mostRuns。文档中没有其他参数。
seriesId 和 statsType 从哪里获取?
seriesId 取自系列赛列表或系列赛归档接口的 id 字段;statsType 取自系列赛统计筛选接口返回的 value 字段,并原样传回即可。
如何解读 headers 和 values 数组?
示例中 headers 为 Batter、M、I、R、SR,values 中的每个元素都带有一个包含六个字符串的 values 数组。第一个字符串看起来是球员 id,第二个是球员姓名,其余四个依次对应 M、I、R 和 SR 列,所以每一行比 headers 多一个字符串。
这些数据是数字还是字符串?
是字符串。行内的每一项,包括跑分和打击率,都以文本形式返回。排序或求平均之前请先显式转换,并自行决定客户端如何处理缺失值或占位值。
statsType 不是 mostRuns 时会有什么变化?
现有证据只展示了默认 mostRuns 的响应,因此其他 statsType 取值下列表对象的名称、表头和 filter 内容在此均未记录。请调用系列赛统计筛选接口查看有效取值,再针对自己的系列赛对比各个响应。
这是全球球员排名吗?
不是。该表仅限于 seriesId 指定的那一个系列赛,同一个 statsType 在不同系列赛中可能返回不同的领先者。如需按赛制划分的全球球员排名,请使用本产品的排名类接口。
某个系列赛可能没有统计数据吗?
覆盖范围取决于具体系列赛,而现有证据只记录了有数据的 200 示例。请在客户端处理列表为空或缺失的情况,不要假定每个 seriesId 都会返回十五行数据。