按类型获取板球系列赛列表:国际赛、联赛、国内赛或女子赛事
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回按月份分组的板球系列赛,类型由必填的路径参数 type 选择。文档中的取值有 international、league、domestic 和 women,默认值是 international。一次 type=international 的探测调用返回了 HTTP 200 和一个 JSON 对象,其中包含 seriesMapProto 数组(该样本中有 11 个月份分组)、appIndex 对象(seoTitle 和 webURL),以及 contentFilters 数组,数组里只有一个条目,filterId 为 liveStream,filterName 为 Live Streaming。seriesMapProto 的每个分组都有一个日期标签(如 OCTOBER 2026)和一个 series 数组。每个系列赛条目包含 id(数字)、name、startDt 和 endDt,两个日期都以毫秒级纪元时间戳字符串的形式序列化。这个 id 就是本产品其他系列赛接口所使用的 seriesId。league、domestic 和 women 三个取值来自参数说明,没有经过探测调用验证。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/series-list API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-list?key=<API_KEY>&type=international'
查询结果
使用场景
- 利用 seriesMapProto 数组搭建赛事发现选择器,同时把 appIndex 元数据与系列赛行数据分开处理。
- 做一个带有国际赛、联赛、国内赛和女子赛事视图的标签页浏览器,每个 type 取值各调用一次该接口。
- 利用日期标签和 startDt 值,按月份展示当前和即将进行的巡回赛与联赛日历。
- 为系列赛流程的发现步骤提供数据:在这里选出一个 id,再传给比赛、阵容或场馆接口。
- 对同一类型的两次轮询结果比较 id 集合,识别新增的系列赛。
- 保留分组与系列赛条目的上下文,而不是把所有嵌套对象拍平,并误当成单一的赛事行。
常见问题
type 参数接受哪些取值?
参数说明列出了 international、league、domestic 和 women。只有 international 有探测调用记录,所以在基于其余三个取值开发之前,请对照自己预期的数据覆盖范围做检查。
系列赛条目的 id 要怎么用?
把它作为 seriesId 传给本产品的其他系列赛接口,例如比赛、阵容、场馆和新闻。历史系列赛列表接口针对过往赛事返回的也是同一种 id。
startDt 和 endDt 是什么格式?
它们是以字符串形式序列化的毫秒级纪元时间戳,探测样本中就是这样。请先在客户端把它们解析为数字,再转换成日期,并按你自己的时区处理。
为什么长期进行的赛事会出现在靠前的月份下?
条目是按日期标签分组的。在探测样本中,一项跨越多年的联赛被放在最早的月份分组里,而它的 endDt 远在未来,所以不要假定分组所在的月份就是结束月份或当前月份。
appIndex 和 contentFilters 是什么?
appIndex 携带页面元数据(seoTitle 和 webURL),而 contentFilters 是一个额外的元数据数组,在探测中观察到的是 liveStream 条目。它们都不是系列赛数据行,请与 seriesMapProto 分开读取。
这个接口会列出往年已结束的系列赛吗?
该接口面向当前和即将进行的系列赛。查看往届赛事请使用本产品的历史系列赛列表接口,它支持按年份筛选;返回空列表属于正常的数据覆盖结果。