获取单篇板球新闻的全文与元数据
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回单篇新闻的完整详情,由必填的数字路径参数 `newsId` 指定(默认值 122025)。`newsId` 请取自新闻列表、按分类新闻或按主题新闻接口所返回新闻的 `id` 字段。该接口没有记录到实际探测结果,响应说明来自一份未被截断(3,356 字符)、尚未验证的来源示例。示例中响应体是单个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)、`authors` 数组(每项含 `id`、`imageId`、`name`、`twitterHandle`)、`content` 数组、`headline`、`intro`、`context`、`storyType`、`source`、整数 `id`、字符串时间戳 `publishTime` 与 `lastUpdatedTime`(类似时间戳的数字,单位未说明)、为空的 `entitlements` 对象、带 `caption`、`id`、`source` 的 `coverImage`,以及 `tags` 数组和 `format` 数组。`content` 的每个条目要么是 `content` 对象,包含 `contentType`(示例中为 `text`)和 `contentValue`(一个段落),有时还带 `hasFormat`;要么是带 `layout`、`name`、`position` 的 `ad` 对象,因此客户端需要跳过广告位。带有 `hasFormat` 标记的段落中含有简短的占位标记,而 `format` 数组(类型为 `urls` 和 `links` 的条目,各含 `id` 与 `value`)说明了每个标记所代表的内容。`tags` 的每个条目包含 `itemId`、`itemName` 和 `itemType`(示例中为 `team` 与 `player`)。文章正文属于编辑内容,在存储或转载之前请先确认你的内容使用条款,并在正式依赖前用真实响应核对确切的字段集合。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/news-detail API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/news-detail?key=<API_KEY>&newsId=122025'
查询结果
使用场景
- 在应用内阅读器中按 newsId 打开选中的新闻,用返回的字段渲染标题、导语、封面图和分段正文。
- 为编辑工作流准备获准使用的摘要或要点卡片,前提是先确认你的内容使用条款允许你计划进行的处理。
- 汇总每篇已打开报道的 authors 数组以发现作者 id,再交给作者资料和作者文章列表接口,生成作者署名页。
- 把 tags 数组转换成文章下方的相关球队与球员链接,用 itemId 的值去调用对应的球队和球员接口。
- 把详情获取与列表发现分开:列表接口只保存新闻 id,等读者真正打开时再按需请求完整文章。
常见问题
新闻详情接口会返回什么?
它返回由 newsId 指定的一篇新闻。由于没有记录实际探测,数据结构来自一份未验证的来源示例:appIndex、authors、由段落与广告占位组成的 content 数组、headline、intro、context、coverImage、tags、format 以及时间戳。
有效的 newsId 从哪里获取?
使用新闻列表、按分类新闻或按主题新闻接口所返回新闻的 id 字段。默认值 122025 只是参数说明中提供的示例 id,请对照自己的列表响应确认实际 id。
文章正文是如何组织的?
在来源示例中,content 数组的条目是 content 对象(含 contentType 和 contentValue,对应一个段落),并与带 layout、name、position 的 ad 对象混排。跳过广告条目,再按顺序拼接各段落即可还原全文。
hasFormat 和 format 数组有什么用?
在示例中,带 hasFormat 标记的段落含有一个简短的占位标记。format 数组中类型为 urls 和 links 的条目,为每个标记 id 提供对应的值。如果想在正文里生成链接,需要自行替换,这部分行为尚未验证。
如何找到作者或相关球员、球队?
authors 数组列出每位署名作者的 id、name、imageId 和 twitterHandle,tags 数组列出相关球队和球员的 itemId、itemName 和 itemType。把这些 id 传给对应的作者、球队或球员接口即可。
可以存储或转载文章正文吗?
返回的文本属于编辑内容,本文档不授予任何转载权利。在存储、镜像或转载文章正文之前,请先确认适用于你的内容使用条款。
哪些响应字段已经验证过?
没有任何字段通过该接口的实际探测得到确认。这里提到的字段都来自所提供的来源示例,请与你自己的响应对照核实,尤其是时间戳的单位和 format 数组。
传入未知的 newsId 会怎样?
现有资料没有展示未知或已删除 newsId 的响应,可能返回空的响应体或错误状态码,请在客户端做好容错处理。