按赛事类型获取板球历史系列赛列表,支持年份筛选和 lastId 翻页
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回某一类赛事分组的板球历史系列赛,并按年份分组。必填的路径参数 `type`(默认 `international`)可取 `international`、`league`、`domestic` 或 `women` 之一。可选的数字型查询参数 `year` 用于列出该年份的系列赛(参数说明以 2024 为例)。可选的数字型查询参数 `lastId` 是翻页游标:留空即加载第一页,传入本接口返回的某个系列赛的 `id` 值则加载下一页。该接口没有记录过实时探测结果,响应说明来自一份未经验证的来源示例,且示例并未说明对应的 type、year 或 lastId。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)和一个 `seriesMapProto` 数组。每个 `seriesMapProto` 条目带有一个 `date` 字符串(即年份,示例中为 2026)和一个含 20 项的 `series` 数组。每个系列赛包含 `id`(整数)、`name`、`startDt` 和 `endDt`(类似时间戳的数字字符串,时间单位未说明)、`thumborImageId`(整数),部分条目还有 `isDefaultImage` 标记。示例中的 `seoTitle` 读起来像是当前系列赛的标题,而不是历史系列赛的标题,因此在依赖这些内容之前,请用真实响应确认具体字段、每页数量、排序方式,以及某一年没有系列赛时的返回结果。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/series-list-archives API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-list-archives?key=<API_KEY>&type=international'
查询结果
使用场景
- 搭建历史赛事浏览器,让访客先选择赛事类型和年份,页面列出该赛季的所有赛事,再进入其中一个。
- 为统计项目把系列赛名称解析成 id,再把这个 id 用在系列赛阵容、场地或积分榜等接口上。
- 为历史学者或统计人员整理某一年的全部巡回赛和锦标赛清单,每行保存 id、name、startDt 和 endDt。
- 循环遍历年份,为女子或国内板球生成逐赛季时间线,并记录每年返回的系列赛数量,同时也能看出哪些年份的覆盖较薄弱。
- 通过检查 isDefaultImage 识别历史赛事网格里的占位图,对这些系列赛换用中性图块,避免重复展示同一张默认图片。
常见问题
历史系列赛接口返回什么?
它返回所选类型的历史系列赛。由于没有记录过探测结果,数据结构来自一份未经验证的来源示例:一个 appIndex 对象和一个 seriesMapProto 数组,数组由年份条目组成,每个条目带有一个 series 数组,其中是含 id、name、startDt、endDt 和 thumborImageId 的系列赛。
type 可以传哪些值?
参数说明列出了四个值:international、league、domestic 和 women,表单默认是 international。该范围之外的取值没有文档说明,用于生产环境前请先测试。
year 和 lastId 如何配合使用?
year 把列表限定在某一个日历年,例如 2024。lastId 是翻页游标:第一页留空,之后传入上一次响应中某个系列赛的 id。两者如何相互作用没有文档说明,组合使用时请用真实响应核对。
它覆盖有史以来的所有系列赛吗?
没有这样的保证。覆盖范围取决于具体赛事,某个年份或类型可能只返回很少的系列赛,甚至没有。请把这个列表当作目录里的历史视图,而不是全时期、全赛事的完整记录。
列表中的系列赛 id 可以做什么?
把它传给目录中需要 seriesId 的系列赛接口,例如比赛、阵容、场地、新闻和统计。这个 id 值也正是继续翻页时要作为 lastId 传回的值。