按作者查询板球新闻文章列表
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 以新闻详情响应里的 id 为起点,用选定的 authorId 搭建作者主页,展示与该作者相关的文章。
- 搭建以署名为核心的编辑研究队列,并在实现无限滚动或“加载更多”按钮之前,先验证 lastId 是如何接续列表的。
- 把某位作者已发布的标题和导语归档到电子表格,方便编辑回顾一个赛季或一次巡回赛中的报道主题。
- 为阅读清单小组件提供数据,在关注记者的资料卡旁边展示 TA 最新发表的文章。
- 在邮件通讯模板里给某位记者加链接之前,先确认这位新记者是否已经有发表过的文章。
常见问题
作者文章接口会返回什么?
它返回某一位作者撰写的新闻文章列表。由于没有记录到探测结果,数据结构来自一份被截断且未经验证的源示例:包含 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 可能返回空的或内容很少的响应体。所提供的资料没有展示这种情况,因此请在代码里做好防御性处理。