按系列赛 ID 获取板球系列赛使用的场馆与球场列表
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回与某一板球系列赛关联的球场。唯一的输入是必填的数字路径参数 seriesId,其值取自系列赛列表或历史系列赛列表接口返回的 id 字段。源响应示例记录了 appIndex 块(页面元数据 seoTitle 和 webURL)、seriesId、seriesName 以及 seriesVenue 数组。seriesVenue 的每个条目包含 id(数字)、ground、city、country、imageId(字符串)和布尔型 isDefaultImage。以上字段来自源示例而不是实际探测调用。示例中没有坐标、容量、售票或球场场地状况等信息,请不要指望该接口提供这些内容。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在赛事专题页展示与某届系列赛关联的球场,并让读者通过各场馆的 id 继续查看场馆信息。
- 为某次巡回赛准备主办概览,列出主办城市和国家,但不声称提供坐标、门票库存或球场场地状况。
- 按城市对系列赛球场分组,展示一项国内联赛分布在多少个主办城市。
- 在赛程页面的球场筛选器中,填入所选系列赛所属的场馆名称。
- 标出 isDefaultImage 为 true 的场馆,方便编辑团队把它们排进待补真实球场照片的清单。
- 把赛程中比赛场馆信息里出现的球场,与系列赛场馆列表比对,找出赛事资料中缺失的球场。
常见问题
这个接口的 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 等可选字段之前,请先在自己的客户端里做验证。