按统计类型(默认 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 功能

用 statsType 选择纪录类型 必填的 statsType 字符串决定返回哪一张纪录表,文档默认值为 mostRuns,其他可选值由本产品的纪录筛选接口列出。
年份、球队、对手与赛制筛选 year、team、opponent 和 matchType 四个可选数字参数可以缩小结果范围,请求可以精确描述某支球队在某个赛制或某个年份对阵某个对手的纪录。
响应自带筛选列表 filter 对象同时返回 matchtype 与 team 两个带 ID 的列表,展示纪录表的同一个响应也提供了下一次缩小范围所需的 ID。
球队 ID 搭配简称 filter.team 把每个 id 与 teamShortName 配对(示例中有 IND、PAK 等),无需再额外查询就能做出简洁的球队选择器。
赛制 ID 与当前赛制 filter.matchtype 把 matchTypeId 对应到赛制说明(示例中为 test、odi、t20),selectedMatchType 则告诉你返回的表格属于哪一种赛制。
表头加按位置排列的数据行 headers 数组给出列名(示例中为 Batter、M、I、R、SR),每一行是包含 values 字符串数组的对象,仅凭响应本身就能搭出完整表格。
每行以球员 ID 开头 在源示例中,每一行的首个字符串是数字,位于球员姓名之前,看起来是球员 ID,核实之后可以与球员相关接口对接。
数值以文本形式返回 比赛场次、局数、得分和击球率都以字符串形式到达(例如 128.02),排序前请显式转换;如果只做展示,可保留原始文本。

在线 API 演示

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

使用场景

常见问题

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

根据源 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 和筛选条件对应的纪录表。仅限某项赛事的表格应使用系列赛统计接口,按赛制划分的球员排名则属于本产品的排名类接口。

相关接口

相关指南

查看订阅方案 →