获取全部板球新闻专题列表,含专题 ID、标题和简介

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

返回编辑专题目录。该接口不需要任何参数,直接发起 GET 请求即可获得服务提供的全部专题。此接口没有留存实际探测记录,下面的响应说明来自一份未经验证、且在 4,000 个字符处被截断的源示例。示例中响应体是一个带有 `topics` 数组的对象,每个条目包含三个字段:`id`(整数)、`headline`(专题标题)和 `description`(一句简短的自由文本)。示例里的专题是围绕某个事件或故事线整理的合集,例如拍卖会、球队前瞻系列、赛事争议或球员退役。示例中的 id 从 375 开始往下排,中间有跳号,所以不要假定它们连续或已排序。部分 description 的内容更像署名或标题的重复,而不是内容摘要,因此请用 `headline` 作为标签,把 `description` 当作可选的展示文字。记下所选专题的 `id`,再把它传给按专题获取新闻的接口,即可加载该专题下的报道。在依赖这些内容之前,请用真实响应确认具体字段、专题总数及其排序。

API 功能

一次请求获取完整专题目录 不带任何参数的单次 GET 请求即可返回全部编辑专题,专题菜单或订阅页面用一份响应就能搭建出来,不需要反复查询。
专题 id 对应专题资讯流 每个条目都带有整数 id,它就是按专题获取新闻接口所需的 topicId,所以本列表是加载任何专题报道之前的发现步骤。
标题可直接用作菜单标签 示例中的 headline 字段是专题标题,例如某场拍卖会或某个球队前瞻系列,长度很短,可以直接放进导航标签或设置列表。
可选的简介文字 示例中每个专题都附带一个 description 字符串,但有些内容更像署名或重复了标题,所以更适合作为辅助文字,布局上不要把它当作必填项。
围绕事件与故事线的专题 示例列出了赛事前瞻、争议事件和休赛期报道等有时间属性的合集,适合跟随板球赛历来组织的编辑导航。
固定请求,便于缓存 没有路径或查询参数,每次调用的请求都完全相同,因此很容易缓存、定时拉取,或监控是否有新增专题。

在线 API 演示

GET /api/project/cricbuzz-cricket/news-get-topics

无需参数,点击查询即可调用 API。

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

新闻专题接口会返回什么?

返回编辑专题列表。此接口没有实际探测记录,数据结构来自一份被截断且未经验证的源示例:一个带有 topics 数组的对象,数组中每个条目包含整数 id、headline 和 description。

这个接口需要任何参数吗?

不需要。该接口没有路径参数或查询参数,直接请求这个路径就能拿到完整的专题列表。现有资料中也没有说明筛选或分页选项。

怎样使用这个列表里的专题 id?

把想要的专题 id 作为 topicId 传给按专题获取新闻的接口,它会返回该专题下的报道。本列表只用来帮你找到 id 和展示用的标签。

专题和新闻分类有什么区别?

专题是围绕事件报道等编辑故事线整理的合集,而分类来自另一个接口,是另一条导航维度。请把两种 id 区分开,因为分类 id 不是专题 id。

专题 id 是连续的或已排序的吗?

不要这样假定。在源示例中 id 从 375 开始往下排并有跳号,例如从 366 直接跳到 364,但示例被截断,真实的排序和完整范围都无法确认。

description 一定是对专题的概括吗?

不一定。示例中大部分简介是简短的概述,但有少数更像署名行或重复了标题。请用 headline 作为标签,把 description 当作可选的辅助文字。

一共会返回多少个专题,列表多久更新一次?

资料没有说明。源示例在 4,000 个字符处被截断,所以专题总数未知,也没有文档记录更新频率。请把列表缓存一段合理的时间,并按计划刷新。

哪些响应字段是已验证的?

没有任何字段经过验证。此接口没有探测记录,topics 数组以及 id、headline、description 字段都只来自被截断的源示例,需要用真实响应来确认。

相关接口

相关指南

查看订阅方案 →