按系列赛 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在所选系列赛的赛程和积分榜旁边展示相关报道,使用与赛程、排名视图相同的 seriesId,让赛事页面的数据口径保持一致。
- 按 seriesId 生成赛事简报,避免用关键词搜索把名称相近的不同届次混在一起,再用报道 id 把每条标题链接到新闻详情接口。
- 为某个巡回赛或联赛搭建系列赛专题页,新闻标签页列出标题和导语,并为没有任何报道的系列赛准备好空状态提示。
- 运行定时任务,记录每个系列赛已见过的报道 id 并标出新增 id,让邮件通讯或提醒只推送最新的赛事报道。
- 统计多个系列赛各自的报道数量,并按 storyType 分组,比较哪些赛事更受编辑关注,哪些赛事的赛前预览、专题和战报更多。
常见问题
系列赛新闻接口会返回什么?
返回某一个系列赛的新闻报道。此接口没有实际探测记录,数据结构来自一份被截断且未经验证的源示例:包含 appIndex 对象、lastUpdatedTime 字符串和 storyList 数组,数组条目是报道对象或广告占位对象。
有效的 seriesId 从哪里获取?
使用系列赛列表或系列赛归档接口返回的 id 字段。默认值 3636 是参数说明里提供的示例 id,在界面上标注它对应哪个赛事之前,请先在自己的系列赛响应里核对。
可以翻页查看某个系列赛更早的报道吗?
现有资料只记录了 seriesId 这一个路径参数,没有分页游标。会返回多少条报道、能否取到更早的报道,需要用真实响应来确认。
为什么 storyList 里有些条目没有报道字段?
在源示例中,部分条目是带有 layout、name、position 的广告对象,而不是报道对象。构建文章卡片时,请跳过没有 story 键的条目。
怎样读取某条报道的全文?
每条报道都带有一个整数 id。把这个 id 传给新闻详情接口即可获取文章正文,因为本接口只返回标题、导语和封面图引用。
lastUpdatedTime 能表示最新一条报道的发布时间吗?
不一定可靠。示例中 lastUpdatedTime 的数值比所有 pubTime 都大,看起来更像页面级时间戳,而不是报道日期。两个字段的单位都没有文档说明,用于排序或判断新鲜度之前请先验证。
哪些响应字段是已验证的?
没有任何字段经过验证。此接口没有探测记录,源示例又在 4,000 个字符处被截断,所以字段名、类型和报道数量在你查看真实响应之前都不能视为已确认。
某个系列赛没有新闻时会怎样?
资料没有说明。请把缺失或为空的 storyList 当作正常结果处理,因为是否有报道取决于具体系列赛,界面上显示空状态即可,不要当作错误。