按系列赛 ID 获取板球系列赛使用的场馆与球场列表

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

返回与某一板球系列赛关联的球场。唯一的输入是必填的数字路径参数 seriesId,其值取自系列赛列表或历史系列赛列表接口返回的 id 字段。源响应示例记录了 appIndex 块(页面元数据 seoTitle 和 webURL)、seriesId、seriesName 以及 seriesVenue 数组。seriesVenue 的每个条目包含 id(数字)、ground、city、country、imageId(字符串)和布尔型 isDefaultImage。以上字段来自源示例而不是实际探测调用。示例中没有坐标、容量、售票或球场场地状况等信息,请不要指望该接口提供这些内容。

API 功能

一届赛事的全部球场 传入一个 seriesId,就能返回与该赛事或巡回赛关联的球场,系列赛页面不需要再单独去搜索场馆。
回传系列赛名称 响应会重复返回 seriesId 和 seriesName,客户端可以在渲染列表之前确认请求落到了预期的那一届赛事上。
球场、城市与国家标签 seriesVenue 的每个条目都有 ground、city 和 country 字符串,足够用来制作场馆表格或主办城市汇总。
数字场馆 ID 作稳定键 每个条目都有数字 id。示例里有位于 Whangarei 的两个球场 Cobham Oval 和 Cobham Oval (New),id 不同,所以应当以 id 而不是名称作为行的键。
默认图片标识 imageId 与 isDefaultImage 可以告诉你某个场馆是否使用共享的占位图片。示例中所有条目共用同一个 imageId,并且都被标记为默认图。
可选的 appIndex 页面元数据 appIndex 对象附带 seoTitle 与 webURL 两个字符串,你可以忽略它们,也可以把它们作为独立的页面元数据保留。

在线 API 演示

GET /api/project/cricbuzz-cricket/series-get-venues

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

这个接口的 seriesId 从哪里获取?

使用系列赛列表或历史系列赛列表接口返回的 id 字段。默认值 3718 是一个示例 id,源响应示例把它对应到新西兰的一项国内一流赛事。

它会返回坐标、容量或球场场地状况吗?

文档中没有这类字段。源示例对每个场馆只列出 id、ground、city、country、imageId 和 isDefaultImage,如果你需要地理位置、座位数或球场场地报告,请改用其他数据来源。

为什么两个场馆看起来几乎一模一样?

示例中包含位于 Whangarei 的 Cobham Oval 和 Cobham Oval (New),两者的 id 不同。请把数字 id 当作球场的唯一标识,把名称仅仅当作展示用的标签。

imageId 和 isDefaultImage 是什么意思?

imageId 是指向图片的字符串引用,不是 URL。isDefaultImage 为 true 表示使用的是共享的占位图。在源示例中,每个场馆都带有这个标记,且 imageId 相同。

如果某个系列赛没有返回场馆怎么办?

数据覆盖取决于具体赛事。请把空的或缺失的 seriesVenue 数组以及任何非 200 响应都当作正常的空状态处理,也不要假定应当改用另一个 seriesId。

这个接口经过实际调用验证吗?

没有。该接口没有留存探测调用记录,文档中的字段来自源示例,所以在依赖 city、country、imageId 等可选字段之前,请先在自己的客户端里做验证。

相关接口

相关指南

查看订阅方案 →