按球队 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 功能

以球队为单位的统计 路径中的 teamId 决定返回哪支球队的统计,该 ID 与球队列表接口中用于阵容、赛果和赛程的 ID 一致。
五项请求筛选 statsType 为必填,matchType、opponent、team 和 year 为可选的数字筛选,一个接口即可覆盖多种球队统计切片,无需拆分成多个接口。
筛选项随结果一并返回 filter 对象在响应中直接给出赛制列表和球队列表,客户端可据此生成选择器,不必再发一次查询请求。
赛制 ID 与名称对应 filter.matchtype 将每个 matchTypeDesc 与 matchTypeId 字符串配对(示例中 test 为 1、odi 为 2、t20 为 3),该 ID 即为 matchType 参数应回传的值。
回显当前选中项 filter 对象中的 selectedMatchType 与 selectedTeam 表明当前响应对应的赛制和球队,页面可据此高亮已选中的筛选标签。
覆盖面广的球队目录 filter.team 列出大量球队,每项带有 id 与 teamShortName,涵盖国家队、女子球队和联赛球队,可直接作为对手选择器的数据来源。
按日历年份缩小范围 year 参数接受 2021 这样的纯数字,在其他筛选条件保持不变时,客户端可以逐个赛季翻看同一支球队的数据。

在线 API 演示

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

使用场景

常见问题

球队统计接口会返回什么内容?

根据源文档中的 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 对象,不去猜测统计字段的具体结构。

相关接口

相关指南

查看订阅方案 →