按作者 ID 获取板球新闻作者资料
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →按必填的数字路径参数 `authorId`(默认值 197)返回某一位新闻作者的资料。authorId 可从新闻详情响应里 `authors` 数组中的 `id` 字段获取。该操作没有查询参数,一次请求只返回一份作者资料。该操作没有记录到实际探测结果,因此响应说明来自一份提供的源示例,它能解析为完整的 JSON 对象,但未经验证。示例中包含六个键:`id`(整数,与请求的作者一致)、`name`(字符串)、`designation`(字符串,例如职位头衔)、`aboutMe`(简短的个人简介字符串)、`imageId`(整数)和 `twitterHandle`。尽管名字叫 handle,示例里的 `twitterHandle` 存放的却是完整的主页链接,而不是单纯的用户名,所以不要假定它是某种用户名格式。`imageId` 是本目录中图片类操作所用的标识,并不是可以直接使用的图片地址。部分作者的字段可能缺失或为空,公开的社交账号引用也只是展示数据。在依赖这些内容之前,请用实际响应确认字段集合和类型。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 当文章页出现作者链接时,用目录中的姓名、职位、图片和简介渲染一张署名资料卡。
- 把本资料接口与同一 authorId 的作者文章列表配合使用,把文章作者链接到作者文章视图,而无需自行编造联系方式。
- 为新闻编辑部或球迷站点的撰稿人页面,建立带有职位头衔和简短简介的记者名录。
- 把作者资料与新闻详情数据一并缓存,这样重复浏览文章时就不会反复请求同一份简介。
- 在作者卡片上展示可选的公开社交链接,同时把它视为展示数据,而不是联系本人的许可。
常见问题
作者信息接口会返回什么?
它以 JSON 对象的形式返回一份作者资料。由于没有记录到探测结果,数据结构来自一份提供的源示例,键包括 id、name、designation、aboutMe、imageId 和 twitterHandle。在你自己的响应里看到之前,请视为未经验证。
authorId 从哪里获取?
使用新闻详情响应里 authors 数组中某个元素的 id 字段。示例值 197 是参数说明里的默认值。同一个 id 也可用于作者文章列表操作。
twitterHandle 是用户名还是链接?
在源示例中它存放的是完整的主页链接,而不是单纯的用户名。渲染成链接之前请先校验该字符串,也不要假定每位作者都有取值。
如何显示作者头像?
响应给出的是整数 imageId,而不是图片地址。请用这个标识调用本目录的图片类操作来获取头像,并在显示之前确认图片确实存在。
有查询参数或翻页吗?
没有。只有 authorId 这个路径参数,该操作返回的是单个资料对象,而不是列表。
可以用资料数据去联系作者吗?
该操作提供的是用于展示的公开资料文字和公开社交引用,不包含联系方式,公开链接也不应被当作可以主动联系对方的许可。
authorId 不存在时会怎样?
所提供的资料没有展示该操作的错误或空结果情形,请自行测试,并对资料缺失、字段为空或非成功状态码做好防御性处理。