获取板球最新新闻列表,可选普通或付费专区信息流,支持 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 基于已确认的 storyList 数组构建头条发现信息流,让 appIndex 对象保持在文章集合之外。
- 把字符串形式的 lastUpdatedTime 保留为信息流元数据,只对读者点开的新闻,用列表项中的 id 去调用新闻详情接口。
- 在球迷网站首页放置最新板球新闻模块,展示 hline、intro 和封面图署名,并按 storyType 分成筛选标签。
- 定时轮询普通信息流,并与已存储的新闻 id 做比对,让提醒或邮件通讯任务只推送新增内容。
- 在测试环境里对比 index 与 premiumIndex 的响应,先弄清付费内容是如何描述的,再设计任何付费标识。
常见问题
最新板球新闻接口会返回什么?
返回一个 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 存在。