按系列赛 ID 获取板球系列赛或赛事的新闻报道列表

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

按必填的数字路径参数 `seriesId`(默认值 3636)返回某一个板球系列赛的新闻报道。seriesId 取自系列赛列表或系列赛归档接口返回的 `id` 字段。该接口不接受其他参数,现有资料也没有说明分页游标。此接口没有留存实际探测记录,下面的响应说明来自一份未经验证、且在 4,000 个字符处被截断的源示例。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)、`lastUpdatedTime` 字符串和 `storyList` 数组。`storyList` 的每个条目要么是 `story` 对象,要么是带有 `layout`、`name`、`position` 的 `ad` 广告位对象,所以客户端需要跳过广告位。单条报道包含 `id`(整数)、`hline`、`seoHeadline`、`intro`、`context`(示例中为系列赛名称)、`storyType`(例如 News 或 Match Features)、`source`、`imageId`、`pubTime`(一串类似 epoch 的数字字符串,单位未说明)、空的 `adsType` 和 `entitlements` 对象,以及带有 `caption`、`id`、`source` 的 `coverImage`。在依赖这些内容之前,请用真实响应确认具体字段、返回的报道数量,以及某个系列赛没有报道时的表现。

API 功能

按系列赛筛选的报道流 只需一次 GET 请求并传入路径参数 seriesId,就能拿到某个巡回赛、联赛或锦标赛对应的新闻报道,系列赛页面不必再在客户端从综合新闻流里自行过滤。
系列赛 ID 来自系列赛列表 seriesId 就是系列赛列表或系列赛归档接口返回的 id 值。表单已预填 3636,可以立刻发出第一个请求,再换成任意其他系列赛 id。
不会混淆不同届次的赛事 数字 id 指向某个循环举办赛事的某一届,不会像关键词搜索那样,把名称相近、年份不同的赛事报道混在一起。
context 字段带系列赛名称 在源示例中,每条报道的 context 字段写着系列赛名称,客户端在渲染卡片之前,可以据此确认这条报道确实属于所请求的赛事。
同一赛事内的报道类型 示例中的 storyType 字段把普通新闻和比赛专题等其他形式区分开,同一个系列赛资讯流无需额外请求,就能拆分成多个标签页或筛选按钮。
系列赛新闻页标题与链接 示例中的 appIndex 对象会给出该系列赛新闻页的 seoTitle 字符串和 webURL 字符串,可以直接用作页面标题,或放在报道列表旁边作为参考链接。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

系列赛新闻接口会返回什么?

返回某一个系列赛的新闻报道。此接口没有实际探测记录,数据结构来自一份被截断且未经验证的源示例:包含 appIndex 对象、lastUpdatedTime 字符串和 storyList 数组,数组条目是报道对象或广告占位对象。

有效的 seriesId 从哪里获取?

使用系列赛列表或系列赛归档接口返回的 id 字段。默认值 3636 是参数说明里提供的示例 id,在界面上标注它对应哪个赛事之前,请先在自己的系列赛响应里核对。

可以翻页查看某个系列赛更早的报道吗?

现有资料只记录了 seriesId 这一个路径参数,没有分页游标。会返回多少条报道、能否取到更早的报道,需要用真实响应来确认。

为什么 storyList 里有些条目没有报道字段?

在源示例中,部分条目是带有 layout、name、position 的广告对象,而不是报道对象。构建文章卡片时,请跳过没有 story 键的条目。

怎样读取某条报道的全文?

每条报道都带有一个整数 id。把这个 id 传给新闻详情接口即可获取文章正文,因为本接口只返回标题、导语和封面图引用。

lastUpdatedTime 能表示最新一条报道的发布时间吗?

不一定可靠。示例中 lastUpdatedTime 的数值比所有 pubTime 都大,看起来更像页面级时间戳,而不是报道日期。两个字段的单位都没有文档说明,用于排序或判断新鲜度之前请先验证。

哪些响应字段是已验证的?

没有任何字段经过验证。此接口没有探测记录,源示例又在 4,000 个字符处被截断,所以字段名、类型和报道数量在你查看真实响应之前都不能视为已确认。

某个系列赛没有新闻时会怎样?

资料没有说明。请把缺失或为空的 storyList 当作正常结果处理,因为是否有报道取决于具体系列赛,界面上显示空状态即可,不要当作错误。

相关接口

相关指南

查看订阅方案 →