列出板球纪录接口可用的纪录类型(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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 为板球纪录浏览器生成纪录类型下拉框,直接使用 value 与 header 配对,而不是把 statsType 字符串写死在代码里。
- 遍历 statsTypesList 及其 types 数组,在手机端的纪录选择器里渲染击球和投球两个分组栏目。
- 发送纪录请求之前,用返回的 value 字符串校验已保存或用户手动输入的 statsType,这样像 mostRun 这样的拼写错误在客户端就能被发现。
- 应用启动时缓存这份目录并定期刷新,使新增或下线的纪录类型无需发版就能反映出来。
- 生成一个术语对照页面,把 lowestEcon、bestBowlingInnings 等代码映射到显示标题,供编辑和客服人员查阅。
常见问题
纪录筛选接口会返回什么内容?
根据源文档中的 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 已从列表中消失的情况,而不要假定它是固定不变的集合。