按类别查询板球球队列表:国际队、联赛队、国内队或女子队,返回球队 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 为板球应用搭建球队选择器,提供国际队、联赛队、国内队和女子队四个标签页,每个标签页用不同的 type 值调用一次接口。
- 建立以 teamId 为键的国家与球队对照表,让记分卡、赛程和新闻条目都能标注球队名称和简称。
- 把只含 teamName 的行当作分组标题,把其后的行当作该组球队,渲染带分组的球队目录页。
- 预取 teamId,驱动定时任务,为所选类别中的每支球队拉取赛果、赛程和球员名单。
- 将自己数据库中保存的球队标识与当前目录对账,找出新增、改名或缺失的球队。
常见问题
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 类别。