列出板球纪录接口可用的纪录类型(statsType 取值),按击球和投球分组并附带显示标题

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

返回板球纪录接口在 statsType 参数中可接受的纪录类型目录。该接口不需要任何参数,没有路径、查询或请求体输入可设置。源文档中的 200 示例是一个包含 statsTypesList 数组的对象。数组中每个元素带有 category 字符串和 types 数组,types 中的每一项又包含 category 字符串、header 字符串(用于显示的标题,例如 Most Runs)和 value 字符串(作为 statsType 发送的机器取值,例如 mostRuns)。示例列出两个分组:Batting(击球)共九种类型(mostRuns、highestScore、highestAvg、highestSr、mostHundreds、mostFifties、mostFours、mostSixes、mostNineties),Bowling(投球)共六种类型(mostWickets、lowestAvg、bestBowlingInnings、mostFiveWickets、lowestEcon、lowestSr)。示例中 bestBowlingInnings 的 header 是 Best Bowling 后面带一个空格,所以在比较显示标题之前请先去掉首尾空白。示例中不包含球队列表或赛制列表,这些筛选项出现在纪录接口自身的响应里。该接口没有实时探测记录,这里描述的所有字段均来自源示例,未经独立验证,现有资料也没有显示该列表是否会随赛季或覆盖范围而变化。

API 功能

无需参数的目录调用 该接口没有路径、查询或请求体输入,客户端在启动时发一次普通 GET 请求,就能拿到完整的纪录类型列表。
击球与投球两个分组 statsTypesList 将纪录类型拆分为分类组,源示例中为 Batting 和 Bowling,选择器可以直接依据响应渲染分组栏目。
取值与标题成对出现 每个类型同时带有 highestAvg 这样的机器取值和 Best Batting Average 这样的可读标题,发送的代码与展示给用户的文字保存在同一个对象里。
对应纪录接口的 statsType 输入 value 字符串就是纪录接口在 statsType 中要求的输入,应用无需把纪录代码写死或自行猜测。
示例中共十五种类型 源示例列出九种击球类型和六种投球类型,涵盖跑分、百分、边界球、门柱、经济率和击球率等维度的纪录。
每个类型都带分类字段 每个类型对象都重复携带自己的 category 字符串,即使把列表展平,也能知道某条记录属于击球纪录还是投球纪录。
需要清理的标题空白 示例中有一个 header(Best Bowling)末尾带空格,这个小细节会影响标题的匹配、排序和去重。

在线 API 演示

GET /api/project/cricbuzz-cricket/stats-get-record-filters

无需参数,点击查询即可调用 API。

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/stats-get-record-filters?key=<API_KEY>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

纪录筛选接口会返回什么内容?

根据源文档中的 200 示例,它返回一个 statsTypesList 数组,由若干分类组构成。每个分组带有 category 字符串和 types 数组,types 中的条目包含 category、header 和 value 字符串。该接口没有实时探测记录,这些字段均未经独立验证。

这个接口需要参数吗?

不需要。该接口没有列出任何路径、查询或请求体参数,直接向接口路径发送普通 GET 请求,再从响应中读取列表即可。

如何把结果用于纪录接口?

取出你想要的类型的 value 字符串,例如 mostRuns,原样作为本产品纪录接口必填的 statsType 参数传入。header 字符串只用于显示。

它也会返回球队和赛制筛选项吗?

源示例中不会,示例里只有 statsTypesList。球队 ID 与赛制 ID 列表出现在纪录接口响应的 filter 对象中,因此如需了解有效的 team、opponent 和 matchType 取值,请调用纪录接口。

示例中出现了哪些纪录类型?

击球类:mostRuns、highestScore、highestAvg、highestSr、mostHundreds、mostFifties、mostFours、mostSixes 和 mostNineties。投球类:mostWickets、lowestAvg、bestBowlingInnings、mostFiveWickets、lowestEcon 和 lowestSr。请以实际响应为准,而不是以这份列表为准。

为什么有一个 header 末尾带空格?

在源示例中,bestBowlingInnings 的 header 是 Best Bowling 后面跟一个空格。客户端在比较或排序之前应先去掉显示字符串的首尾空白。而作为 statsType 发送的 value 字符串在示例中没有这种空格。

可以认为这份列表永远不变吗?

现有资料没有说明列表是否会随赛季、赛事或覆盖范围而变化。可以为了方便而缓存它,同时定期刷新,并处理某个 statsType 已从列表中消失的情况,而不要假定它是固定不变的集合。

相关接口

相关指南

查看订阅方案 →