按作者 ID 获取板球新闻作者资料

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

按必填的数字路径参数 `authorId`(默认值 197)返回某一位新闻作者的资料。authorId 可从新闻详情响应里 `authors` 数组中的 `id` 字段获取。该操作没有查询参数,一次请求只返回一份作者资料。该操作没有记录到实际探测结果,因此响应说明来自一份提供的源示例,它能解析为完整的 JSON 对象,但未经验证。示例中包含六个键:`id`(整数,与请求的作者一致)、`name`(字符串)、`designation`(字符串,例如职位头衔)、`aboutMe`(简短的个人简介字符串)、`imageId`(整数)和 `twitterHandle`。尽管名字叫 handle,示例里的 `twitterHandle` 存放的却是完整的主页链接,而不是单纯的用户名,所以不要假定它是某种用户名格式。`imageId` 是本目录中图片类操作所用的标识,并不是可以直接使用的图片地址。部分作者的字段可能缺失或为空,公开的社交账号引用也只是展示数据。在依赖这些内容之前,请用实际响应确认字段集合和类型。

API 功能

一次请求取得作者资料 只需一次带 authorId 路径参数的 GET 请求,就能返回精简的资料对象,渲染署名卡片时既不用解析文章正文,也不用先调用搜索接口。
姓名与职位同在一个对象 源示例把 name 字符串与 designation 字符串放在一起,足以在文章标题下方显示“作者姓名 + 记者或编辑职位”这样的一行署名。
简短的个人简介文字 示例中的 aboutMe 字段是一句话的个人简介,可以填入文章页的作者介绍框,但其他作者的简介长度和是否存在尚未得到确认。
用于头像的图片 ID 整数类型的 imageId 字段通过本目录的图片类操作指向作者头像,资料卡可以单独去查询图片,而不必热链接某个固定地址。
以链接形式给出的社交引用 示例中的 twitterHandle 字段是完整的主页链接。客户端可以把它作为可选链接展示,但因为它并不是单纯的用户名,渲染前应先校验取值。
回显作者 id 便于关联 响应会重复返回作者的 id,页面可据此确认资料与请求的 authorId 一致,再用同一个值去关联作者文章列表操作。

在线 API 演示

GET /api/project/cricbuzz-cricket/news-get-author-info

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

作者信息接口会返回什么?

它以 JSON 对象的形式返回一份作者资料。由于没有记录到探测结果,数据结构来自一份提供的源示例,键包括 id、name、designation、aboutMe、imageId 和 twitterHandle。在你自己的响应里看到之前,请视为未经验证。

authorId 从哪里获取?

使用新闻详情响应里 authors 数组中某个元素的 id 字段。示例值 197 是参数说明里的默认值。同一个 id 也可用于作者文章列表操作。

twitterHandle 是用户名还是链接?

在源示例中它存放的是完整的主页链接,而不是单纯的用户名。渲染成链接之前请先校验该字符串,也不要假定每位作者都有取值。

如何显示作者头像?

响应给出的是整数 imageId,而不是图片地址。请用这个标识调用本目录的图片类操作来获取头像,并在显示之前确认图片确实存在。

有查询参数或翻页吗?

没有。只有 authorId 这个路径参数,该操作返回的是单个资料对象,而不是列表。

可以用资料数据去联系作者吗?

该操作提供的是用于展示的公开资料文字和公开社交引用,不包含联系方式,公开链接也不应被当作可以主动联系对方的许可。

authorId 不存在时会怎样?

所提供的资料没有展示该操作的错误或空结果情形,请自行测试,并对资料缺失、字段为空或非成功状态码做好防御性处理。

相关接口

相关指南

查看订阅方案 →