获取全部板球新闻专题列表,含专题 ID、标题和简介
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回编辑专题目录。该接口不需要任何参数,直接发起 GET 请求即可获得服务提供的全部专题。此接口没有留存实际探测记录,下面的响应说明来自一份未经验证、且在 4,000 个字符处被截断的源示例。示例中响应体是一个带有 `topics` 数组的对象,每个条目包含三个字段:`id`(整数)、`headline`(专题标题)和 `description`(一句简短的自由文本)。示例里的专题是围绕某个事件或故事线整理的合集,例如拍卖会、球队前瞻系列、赛事争议或球员退役。示例中的 id 从 375 开始往下排,中间有跳号,所以不要假定它们连续或已排序。部分 description 的内容更像署名或标题的重复,而不是内容摘要,因此请用 `headline` 作为标签,把 `description` 当作可选的展示文字。记下所选专题的 `id`,再把它传给按专题获取新闻的接口,即可加载该专题下的报道。在依赖这些内容之前,请用真实响应确认具体字段、专题总数及其排序。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 为专题订阅界面发现可选的编辑专题,让读者挑选自己想追的故事线,并把所选 id 保存到其个人资料中。
- 把专题导航与分类导航分开设计,读者打开某个专题页时,再把所选 topicId 传给专题资讯流接口。
- 缓存专题列表并按计划刷新,让新闻应用用已存储的数据构建专题菜单,而不是每次浏览页面都去请求。
- 把返回的 id 与上次保存的列表做差异对比,发现新增专题,当拍卖会或赛事前瞻之类的新事件专题出现时,提醒编辑或订阅用户。
- 把专题标题映射到正在跟踪的运营活动,例如联赛前瞻与争议事件报道,并保存对应的 id,供之后调用专题资讯流使用。
常见问题
新闻专题接口会返回什么?
返回编辑专题列表。此接口没有实际探测记录,数据结构来自一份被截断且未经验证的源示例:一个带有 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 字段都只来自被截断的源示例,需要用真实响应来确认。