按类别查询板球球队列表:国际队、联赛队、国内队或女子队,返回球队 ID、名称、简称与图片 ID

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

返回某一类别的板球球队目录。唯一必填的路径参数是 type,接口文档给出的取值为 international、league、domestic 或 women,默认值为 international。使用 type=international 做过一次实时探测,返回 HTTP 200 和一个 JSON 对象,其中包含 list 数组(40 行)以及带有 seoTitle 和 webURL 字符串的 appIndex 对象。在该探测结果中,list 混合了两种行:一种是球队行,带有数字类型的 teamId、teamName、teamSName 和 imageId,其中部分行还带有 countryName;另一种是分组标题行,只包含 teamName,例如 Test Teams 和 Associate Teams。只探测过 international 这一类别,league、domestic 和 women 的结构尚未验证,分组方式以及出现哪些可选字段都可能不同。拿到的 teamId 可以用于其他球队接口,查询球员、赛果、赛程、新闻和统计数据。

API 功能

一个路径覆盖四类球队 把 type 路径段设为 international、league、domestic 或 women,就能切换返回哪一类球队目录,请求的其他部分无需改动。
稳定的 teamId 衔接后续调用 每个球队行都带有数字类型的 teamId,可以传给球队球员、赛果、赛程、新闻和统计接口,从所选球队继续往下查询。
名称、简称与图片引用 球队行提供 teamName、teamSName(例如 IND 或 AUS)和 imageId,足以渲染带标签的选择器或紧凑的队徽列表。
列表中自带分组标题 探测到的 international 响应把 Test Teams 和 Associate Teams 这样的标题行放在各组球队之间,一个数组就已经包含了目录页所需的分组信息。
球队列表页面元数据 appIndex 对象在列表之外还返回 seoTitle 和 webURL 字符串,做球队名单时可以忽略,也可以保留为页面级参考数据。

在线 API 演示

GET /api/project/cricbuzz-cricket/teams-list

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/teams-list?key=<API_KEY>&type=international'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

teams-list 接口会返回什么内容?

返回一个包含 list 数组和 appIndex 对象的 JSON 对象。在探测到的 international 响应中,list 有 40 行:带有 teamId、teamName、teamSName 和 imageId 的球队行(部分行还有 countryName),以及只包含 teamName 的标题行。appIndex 中带有 seoTitle 和 webURL 字符串。

type 参数可以使用哪些值?

接口文档给出的取值是 international、league、domestic 和 women,默认值为 international。实时探测只调用过 international,所以在依赖其他三种类别的分组方式之前,请先检查它们的实际响应。

如何区分列表中的球队和分组标题?

在探测到的响应中,Test Teams 和 Associate Teams 这样的标题行只包含 teamName,而球队行还带有 teamId、teamSName 和 imageId。没有 teamId 的行就当作标题处理,不要假设 list 中的每个元素都是球队。

countryName 一定会出现吗?

不一定。在探测到的响应中,只有部分球队行带有 countryName,例如 India、Pakistan 和 Australia,而 Ireland 或 England 等则没有。请把它当作可选字段处理,缺失时退回使用 teamName。

拿到的 teamId 应该怎么使用?

把 teamId 传给本 API 中的其他球队接口,例如球队球员、赛果、赛程、新闻和统计,就可以从目录跳转到具体的某支球队。请把这些标识保留为数字类型。

列表是否包含某个类别下的全部球队?

覆盖范围取决于各类别可用的数据,所以不要把该列表当作完整或永久不变的注册表。球队数量和顺序都可能随时间变化,而且探测结果只反映某一时刻的 international 类别。

相关接口

相关指南

查看订阅方案 →