按作者查询板球新闻文章列表

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

按必填的数字路径参数 `authorId`(默认值 197)返回某一位作者撰写的新闻文章列表。authorId 可从新闻详情响应里 `authors` 数组中的 `id` 字段获取。可选的数字查询参数 `lastId` 用于翻页:留空即加载第一页,若要获取下一页,则传入上一次响应中最后一篇文章的 `id`(参数说明中给出的示例值为 140342)。该操作没有记录到实际探测结果,因此响应说明来自提供的源示例,该示例在 4000 个字符处被截断,且未经验证。在这个示例中,响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)、`lastUpdatedTime` 字符串和 `storyList` 数组。`storyList` 的每个元素要么是 `story` 对象,要么是带有 `layout`、`name` 和 `position` 的 `ad` 对象,所以客户端需要跳过广告位。一篇 story 包含 `id`(整数)、`hline`、`seoHeadline`、`intro`、`context`、`storyType`、`source`、`imageId`、`pubTime`(由类似时间戳的数字组成的字符串,单位文档中未说明)、一个空的 `entitlements` 对象,以及带有 `caption`、`id` 和 `source` 的 `coverImage`。在正式依赖这些内容之前,请先用实际响应确认具体的字段集合、每页数量,以及作者没有任何文章时的行为。

API 功能

按作者筛选的文章流 只需一次带 authorId 路径参数的 GET 请求,就能拿到署名该作者的文章,作者主页不必再在客户端按姓名去过滤综合新闻流。
基于 lastId 的游标翻页 首页留空 lastId,之后传入上一批最后一篇文章的 id 即可继续加载。翻页依据的是文章 id 而不是页码,所以在新文章不断出现时,读者的阅读位置也不会错位。
storyList 中的文章卡片 未经验证的源示例里,每篇文章都带有 id、标题(hline)、SEO 标题、导语、上下文标签、文章类型、来源名称和发布时间标记,足够直接绘制一张文章卡片,无需再发第二次请求。
封面图引用信息 示例中的文章带有 imageId 以及包含 caption、id 和 source 的 coverImage 对象,卡片可以在配图旁显示署名说明,图片本身则通过图片类操作另行获取。
列表中穿插的广告位标记 示例在文章对象之间穿插了带有 layout、name 和 position 的广告对象。检查每个元素包含哪一种键,客户端就能只保留编辑内容,得到干净的列表。
作者列表页的页面元数据 示例中的 appIndex 对象含有 seoTitle 和 webURL 字符串,可用来给列表页命名。由于没有记录到实际探测,请先确认这些键是否出现在你自己的响应中。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

作者文章接口会返回什么?

它返回某一位作者撰写的新闻文章列表。由于没有记录到探测结果,数据结构来自一份被截断且未经验证的源示例:包含 appIndex 对象、lastUpdatedTime 字符串,以及 storyList 数组,数组元素是文章对象或广告占位对象。

有效的 authorId 从哪里获取?

使用新闻详情响应里 authors 数组中的 id 字段。默认值 197 是参数说明里提供的示例 id。作者信息接口会返回同一个 id 对应的作者资料。

如何加载下一页文章?

第一次调用时让 lastId 留空。要获取下一页,就把上一次 storyList 中最后一篇文章的 id 作为 lastId 传入。参数说明里给出的示例值是 140342。所提供的资料中没有说明每页的数量。

为什么 storyList 里有些元素没有文章字段?

在源示例中,部分元素是带有 layout、name 和 position 的广告对象,而不是文章对象。构建文章列表时请跳过它们。至于每次响应是否都会出现广告元素,目前没有探测结果可以确认。

lastId 是必填的吗?

不是。只有 authorId 必填。lastId 是可选参数,仅在第一次请求之后用于翻页。

哪些文章字段已经验证过?

这个操作的字段都没有经过实际探测确认。此处列出的 hline、intro、storyType、pubTime 和 coverImage 等字段,来自一份在 4000 个字符处被截断的源示例,请对照你自己的响应核实。

这个操作会返回空列表吗?

覆盖情况因作者而异,所以没有文章的作者或不存在的 authorId 可能返回空的或内容很少的响应体。所提供的资料没有展示这种情况,因此请在代码里做好防御性处理。

相关接口

相关指南

查看订阅方案 →