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

每个系列赛一张榜单 路径中的 seriesId 把榜单限定在单个系列赛届次内,同一赛事不同届次的统计数据不会混在同一个响应里。
可选的统计类型 必填的 statsType 查询参数决定返回哪一种榜单,文档默认值为 mostRuns,可选取值由系列赛统计筛选接口列出。
表头加字符串数据行 headers 数组给出各列名称(示例为 Batter、M、I、R、SR),每一行是带 values 字符串数组的对象,客户端无需硬编码列位置即可生成表格。
每行开头的 id 源示例中每行在球员姓名之前都有一个数字字符串,看起来是球员 id,经核实后可作为把数据行关联到球员接口的线索。
比赛类型筛选块 filter.matchtype 数组携带 matchTypeDesc 和 matchTypeId 字符串(示例为 Test 和 1),告诉客户端返回的榜单覆盖哪种赛制。
页面元数据中的系列赛名称 示例中 appIndex.seoTitle 字符串以系列赛名称和赛季开头,可直接作为榜单卡片的现成标题。
数字以文本形式返回 场次、局数、跑分和打击率都以字符串形式返回,排序前请先显式转换为数字;如果只做展示,可以保留打击率的小数文本。

在线 API 演示

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

使用场景

常见问题

系列赛统计接口返回什么内容?

根据源文档的 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 都会返回十五行数据。

相关接口

相关指南

查看订阅方案 →