按统计类型(默认 mostRuns)查询板球纪录榜,可按比赛类型、球队、对手和年份筛选,返回表头与球员数据行
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回某一种板球纪录的排行表。statsType 是唯一必填参数,字符串类型,默认示例值为 mostRuns,可选值来自本产品「纪录筛选」接口返回的 value 字段。另有四个可选的数字查询参数用于缩小范围:matchType(比赛类型 ID,取自本接口响应中 filter.matchtype 列表的 matchTypeId)、team 与 opponent(球队 ID,取自本接口响应中 filter.team 列表)以及 year(日历年份,例如 2021)。根据源 200 示例,响应是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)、filter 对象、headers 数组和 values 数组。filter 对象中,matchtype 列出 matchTypeDesc 与 matchTypeId 字符串(示例中 test 为 1、odi 为 2、t20 为 3),selectedMatchType 为字符串(示例中为 t20),team 列出 id 与 teamShortName 字符串(示例中共十二支球队,如 IND 的 id 为 2、PAK 的 id 为 3)。示例中的 headers 为 Batter、M、I、R、SR,values 中每个元素都是一个对象,内含自己的 values 字符串数组:第一个字符串看起来是球员数字 ID,第二个是球员姓名,后面四个依次对应 M、I、R、SR 列。保存的示例在数十行之后被截断,因此完整行数未得到确认;现有依据也没有说明该示例由哪些请求参数生成,以及换用其他 statsType 时表头会如何变化。本接口没有记录过实时探测,这里描述的所有响应字段均来自源示例,未经独立验证。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/stats-get-records API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/stats-get-records?key=<API_KEY>&statsType=mostRuns'
查询结果
使用场景
- 搭建纪录浏览页:用户先从纪录筛选接口中选定 statsType,再按年份、球队、对手或比赛赛制逐步缩小纪录表。
- 通过 filter.team 列表返回的球队与对手 ID,做出某支球队对阵某个对手的交锋纪录视图。
- 生成按赛季划分的纪录页面:传入 2021 这样的年份,并在每一条导出的数据旁保存该年份,避免不同赛季的数据被混在一起。
- 用 filter.matchtype 填充 Test、ODI、T20 的赛制标签栏,并带上所选 matchType ID 重新加载表格。
- 用每一行开头的 ID 字符串链接到球员资料页,链接之前先与球员搜索结果核对。
- 把范围明确的纪录表连同筛选元数据一起导出,并与系列赛排行榜或近期状态数据清楚区分开。
常见问题
纪录接口会返回什么内容?
根据源 200 示例,返回内容包括 appIndex 对象、含 matchtype、selectedMatchType 和 team 的 filter 对象、headers 数组,以及由球员行组成的 values 数组。本接口没有记录过实时探测,这些字段尚未经过独立验证。
这个接口有哪些参数?
statsType 为必填,放在查询字符串中,字符串类型,默认值为 mostRuns。matchType、opponent、team 和 year 为可选数字,同样放在查询字符串中,没有默认值。文档中没有路径参数或请求体参数。
有效的 statsType 值从哪里获取?
调用本产品的纪录筛选接口,把想要的类型的 value 字段(例如 mostRuns)原样传入即可。请不要自行猜测代码,现有依据只记录了默认值。
球队、对手和 matchType 的 ID 从哪里获取?
从本接口响应的 filter 对象中获取。在源示例里,filter.matchtype 带有 matchTypeId 字符串,filter.team 带有 id 与 teamShortName 字符串。请把这些 ID 以数字形式分别传给 matchType、team 和 opponent 查询参数。
headers 和 values 两个数组应该怎么读?
示例中 headers 为 Batter、M、I、R、SR,values 的每一项都包含一个由六个字符串组成的 values 数组。第一个看起来是球员 ID,第二个是球员姓名,其余四个按顺序对应 M、I、R、SR 列,所以每一行的字符串比 headers 的条目多一个。
数据是数字还是字符串?
是字符串。每一行中的所有内容,包括得分和带小数的击球率,都以文本形式返回。排序或求平均之前请先显式转换。
opponent 是否必须和 team 一起使用?没有匹配纪录时会怎样?
现有依据没有说明 opponent 是否依赖 team,也只记录了一个有数据的 200 示例。请在客户端处理空表或缺失表格的情况,并自行测试 year、team、opponent 与 matchType 的各种组合。
这是系列赛排行榜或实时排名吗?
不是。它返回的是所选 statsType 和筛选条件对应的纪录表。仅限某项赛事的表格应使用系列赛统计接口,按赛制划分的球员排名则属于本产品的排名类接口。