获取板球最新新闻列表,可选普通或付费专区信息流,支持 lastId 翻页

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

以头条信息流的形式返回最新板球新闻。必填的字符串型路径参数 `type`(默认 `index`)用于选择信息流,文档给出的取值为 `index` 或 `premiumIndex`。可选的数字型查询参数 `lastId` 是翻页游标:留空即加载第一页,若要加载下一页,则传入本接口上一页最后一条新闻的 `id`。一次使用 `type=index` 的探测记录返回了 HTTP 200 和一个 JSON 对象,其中包含 `storyList` 数组、`lastUpdatedTime` 字符串和 `appIndex` 对象(`seoTitle`、`webURL`)。该探测结果的 `storyList` 共有 12 个条目:10 个 `story` 新闻对象和 2 个带有 `layout`、`name`、`position` 的 `ad` 广告对象,因此客户端需要跳过广告位。观察到的每条新闻都包含 `id`(整数)、`hline`、`seoHeadline`、`intro`、`context`、`source`、`storyType`、`imageId`(整数)、`pubTime`(由数字组成的字符串,单位文档未说明)、`adsType` 与 `entitlements` 对象(探测中均为空),以及带有 `caption`、`id`、`source` 的 `coverImage`。观察到的 `storyType` 取值有 News、Features、Reports 和 Match Features。另有一个被截断且未经验证的源示例,展示了相同的结构。`premiumIndex` 信息流取值和 `lastId` 续取并未探测过,因此付费信息流的内容、每页条数,以及传入未知游标时的结果都尚未得到确认。

API 功能

普通与付费信息流选择器 type 路径参数用于选择信息流。表单预填了 index,文档给出的另一个取值是 premiumIndex;记录下来的探测只验证过 index。
探测确认的 storyList 数组 记录的探测在 JSON 对象中返回了 storyList 数组,同时还有 lastUpdatedTime 和 appIndex,因此可以基于 storyList 构建头条合集,并让 appIndex 独立于文章列表之外。
新闻条目与广告位混排 在探测结果中,12 个条目里有 10 个是新闻对象,2 个是带有 layout、name 和 position 的广告对象。按 story 键过滤后,即可得到干净的文章列表。
已观察到的新闻类型标签 探测在 storyType 字段中返回了 News、Features、Reports 和 Match Features,可用来在同一个最新新闻页面上驱动筛选标签或分栏。
每条新闻的封面图引用 观察到的每条新闻都带有 imageId 以及包含 id、caption 和 source 的 coverImage 对象,卡片既能拿到图片标识,也能拿到应显示在图片旁的署名文字。
信息流更新时间标记 lastUpdatedTime 以字符串形式返回,客户端可以把它作为信息流元数据保存,在再次请求之前判断缓存的列表是否需要刷新。
可选的 lastId 续取 第一页将 lastId 留空,之后传入已返回的最后一条新闻的 id 即可请求下一页。记录的探测没有覆盖这种续取行为。

在线 API 演示

GET /api/project/cricbuzz-cricket/news-list

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

最新板球新闻接口会返回什么?

返回一个 JSON 对象,包含 storyList 数组、lastUpdatedTime 字符串和 appIndex 对象。使用 type=index 的探测记录返回了 HTTP 200,这三个键齐全,storyList 共有 12 个条目。

type 可以传哪些值?

参数说明给出的取值是 index 和 premiumIndex。记录的探测只使用了 index,因此在依赖 premiumIndex 的内容之前,请先用实际响应确认。

为什么有些 storyList 条目不是文章?

探测结果在新闻对象之间夹有两个带有 layout、name 和 position 的广告对象。渲染或保存标题之前,请先跳过没有 story 键的条目。

怎样请求下一页?

第一页将 lastId 留空,之后把上一次响应中最后一条新闻的 id 作为 lastId 传入,并保持 type 不变。续取行为和每页条数都没有探测过,请在自己的测试中验证。

每条新闻有哪些字段?

观察到的字段有 id、hline、seoHeadline、intro、context、source、storyType、imageId、pubTime、adsType、entitlements,以及带有 caption、id 和 source 的 coverImage。探测中 adsType 与 entitlements 都是空对象。

探测返回了哪些 storyType 值?

News、Features、Reports 和 Match Features。请把它当作样本,因为其他信息流或其他时间可能出现别的取值。

pubTime 和 lastUpdatedTime 的单位是什么?

两者都以数字字符串的形式返回,看起来像时间戳,但文档没有说明单位。转换之前,请先拿几个值与已知的发布日期做比对。

如何获取完整的文章正文?

本接口只列出标题和导语。请用列表项中的 id 调用新闻详情接口来请求完整内容,并先确认该 id 存在。

相关接口

相关指南

查看订阅方案 →