按球队 ID 和统计类型查询板球球队统计,可按赛制、对手、球队或年份筛选,返回内容同时附带赛制与球队筛选列表
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回单支板球球队的统计视图。请在 URL 路径中传入 teamId(必填数字,默认值 2 为文档示例值),并以查询字符串传入必填的 statsType(默认值 mostRuns 为文档示例值)。另有四个可选的数字查询参数用于缩小范围:matchType、opponent、team 和 year(日历年份,文档示例为 2021),这四个参数均没有默认值。teamId 取自球队列表接口返回的 teamId 字段,statsType 取自球队统计筛选接口返回的 value 字段。matchType、opponent 和 team 的取值按文档说明来自本接口自身的返回内容:matchType 使用 matchTypeId 字段,opponent 和 team 使用球队 ID 字段。源文档中的 200 示例是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)和 filter 对象。filter.matchtype 列出 matchTypeDesc 与 matchTypeId 字符串(示例中 test 为 1、odi 为 2、t20 为 3),filter.selectedMatchType 与 filter.selectedTeam 表示当前选中项(示例中为 t20 和 IND),filter.team 是一个很长的数组,每项包含 id 字符串和 teamShortName 字符串,覆盖国家队、女子球队和联赛球队。需要注意,可见示例中的条目使用的是 id,而不是参数说明里提到的 teamId。所给示例在 filter.team 数组中途被截断,因此 statsType 对应的统计数据行在现有资料中看不到,这里也不做描述。该接口没有实时探测记录,以上字段均来自源示例,未经独立验证。路径参数 teamId 与查询参数 team 是两个独立的输入,文档并未说明二者可以互换。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/teams-get-stats API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/teams-get-stats?key=<API_KEY>&teamId=2&statsType=mostRuns'
查询结果
使用场景
- 搭建球队研究页面,用 filter.matchtype 数组生成 Test、ODI、T20 切换按钮,而不是在前端写死赛制按钮。
- 传入对手球队 ID,对比某支球队与指定对手交锋时的数据,并在每条结果中保存 teamId、opponent、matchType 和 statsType,方便之后分辨这份数据对应哪个切片。
- 保持 teamId、statsType 和 matchType 不变,只更换 year 反复调用,做出一支球队的逐年数据浏览器。
- 用 filter.team 中的 id 与 teamShortName 生成对手下拉框,并以观众熟悉的球队简称作为显示文字。
- 在发送统计表单之前先做校验:用球队列表核对 teamId,用 filter.team 核对 opponent 或 team,并按文档说明把 teamId 与 team 作为两个独立字段分别保存。
常见问题
球队统计接口会返回什么内容?
根据源文档中的 200 示例,返回内容包含 appIndex 对象和 filter 对象,filter 中有 matchtype、selectedMatchType、selectedTeam 以及 team 数组。示例在 team 数组中途被截断,所以统计数据行本身在现有资料中看不到。该接口没有实时探测记录,这些字段均未经独立验证。
这个接口需要哪些参数?
teamId 必填,放在 URL 路径中,类型为数字,默认值为 2。statsType 必填,放在查询字符串中,类型为字符串,默认值为 mostRuns。matchType、opponent、team 和 year 是可选的数字查询参数,没有默认值。
teamId 和 statsType 去哪里获取?
teamId 取自球队列表接口返回的 teamId 字段。statsType 取自球队统计筛选接口返回的 value 字段,原样传回即可。
如何找到有效的 matchType、opponent 和 team 取值?
参数说明指出这些值来自本接口自身的响应。可以先只传 teamId 和 statsType 调用一次,再从 filter.matchtype 中读取 matchTypeId,从 filter.team 中读取球队 ID。在可见示例里,这些条目使用的字段名是 id 和 teamShortName。
teamId 和 team 有什么区别?
teamId 是路径参数,指明要查询统计的那支球队。team 是可选的查询参数,其取值来自本接口返回的球队列表。现有资料没有说明 team 与 teamId 同时使用时会如何改变结果,因此请针对自己的球队实际测试这种组合,并且不要把二者互相替换。
有哪些赛制可选?
示例中列出 test 的 matchTypeId 为 1、odi 为 2、t20 为 3,并显示当前选中的赛制是 t20。实际可用赛制请以你自己响应中的 filter.matchtype 数组为准。
如何按年份筛选?
在查询字符串中以数字传入 year,例如 2021。该参数可选且没有默认值,不传则不按年份过滤。现有资料没有显示查询球队历史之外的年份时接口会如何响应。
为什么示例里看不到任何统计数据?
所给的 200 示例在 filter.team 数组中途结束,承载 statsType 结果的那部分内容不可见。因此本说明只描述 filter 对象,不去猜测统计字段的具体结构。