按赛事类型获取板球历史系列赛列表,支持年份筛选和 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 功能

四类赛事的历史列表 路径参数 type 支持 international、league、domestic 和 women,一个接口就能返回每个赛事分组的历史系列赛列表。表单默认选中 international。
可选的年份筛选 传入 2024 这样的年份,只列出该年的系列赛;留空则不按年份浏览。参数说明没有写明不传年份时返回什么,请自行测试默认行为。
系列赛按年份分组 示例中的 seriesMapProto 数组由条目组成,每个条目带有表示年份的 date 标签,其下是 series 数组,适合做逐年展示的历史列表。
可用于深入查询的系列赛标识 每个系列赛对象都有整数 id。用户打开某个历史赛事后,客户端可以把它传给系列赛的比赛、阵容、场地、新闻或统计等接口。
起止日期与封面图字段 示例中的系列赛条目带有 startDt、endDt 和 thumborImageId,部分条目还有 isDefaultImage 标记,因此历史赛事卡片既能显示日期范围,也能区分占位图和真实图片。
用 lastId 游标获取更早的系列赛 第一页让 lastId 留空;要加载下一页,请传入本接口返回的某个系列赛的 id,并在每次请求中保持相同的 type 和 year。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

历史系列赛接口返回什么?

它返回所选类型的历史系列赛。由于没有记录过探测结果,数据结构来自一份未经验证的来源示例:一个 appIndex 对象和一个 seriesMapProto 数组,数组由年份条目组成,每个条目带有一个 series 数组,其中是含 id、name、startDt、endDt 和 thumborImageId 的系列赛。

type 可以传哪些值?

参数说明列出了四个值:international、league、domestic 和 women,表单默认是 international。该范围之外的取值没有文档说明,用于生产环境前请先测试。

year 和 lastId 如何配合使用?

year 把列表限定在某一个日历年,例如 2024。lastId 是翻页游标:第一页留空,之后传入上一次响应中某个系列赛的 id。两者如何相互作用没有文档说明,组合使用时请用真实响应核对。

它覆盖有史以来的所有系列赛吗?

没有这样的保证。覆盖范围取决于具体赛事,某个年份或类型可能只返回很少的系列赛,甚至没有。请把这个列表当作目录里的历史视图,而不是全时期、全赛事的完整记录。

列表中的系列赛 id 可以做什么?

把它传给目录中需要 seriesId 的系列赛接口,例如比赛、阵容、场地、新闻和统计。这个 id 值也正是继续翻页时要作为 lastId 传回的值。

相关接口

相关指南

查看订阅方案 →