获取全部板球新闻分类及其 ID

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

返回板球新闻文章分类的目录。该操作没有路径、查询或请求头参数,一次请求就返回整个列表。该操作没有记录到实际探测结果,因此响应说明来自一份提供的源示例,它能解析为完整的 JSON 对象,但未经验证。示例是一个只含单个 `storyType` 数组的对象,每个元素都有整数 `id`、字符串 `name` 和字符串 `description`。示例列出了 15 个分类,包括 News(id 1)、Editor's Picks(2)、Editorial(3)、Interviews(4)、Specials(5)、Reports(6)、Previews(7)、Statistics & Analysis(8)、Live Blogs(10)、Tour Diaries(13)、Match Features(18)、Features(19)、Social Tattle(20)、Premium Editorials(21)和 Pulse(25)。这些 id 并不连续,所以应当从响应中读取,而不是自己去猜。调用按分类查询新闻列表的操作时,请使用本列表中的 id。分类集合可能随时间变化,请以实际响应确认当前列表。

API 功能

一次调用拿到完整分类体系 无需参数的 GET 请求会在单个 storyType 数组中返回所有新闻分类,导航菜单和筛选器只需一次请求即可搭建,不必逐个分类去查询。
固定的 id、名称与说明 源示例中的每个条目都包含整数 id、显示名称和一句话说明。id 是请求该分类文章时要用的值,名称和说明则可以作为标签页标题或提示文字。
反映的是内容形式而非单纯话题 示例中的分类描述的是文章体裁,如专访、战报、前瞻、图文直播、巡回赛日记和数据分析,可以帮助读者在不同的比赛报道风格之间做选择。
标识编号并不连续 示例中的 id 依次为 1 到 8,然后是 10、13、18 到 21 和 25。从响应里读取 id,可以避免因为默认编号没有空缺而导致筛选条件失效。
没有需要维护的参数 该接口没有必填或可选的输入,所以定时任务可以独立刷新分类列表,不需要维护标识映射,也不必处理翻页逻辑。
来自源示例而非实际探测 该操作没有记录到实际探测结果。这份包含 15 项的列表来自提供的示例,部署时应与真实响应对比,并把新增或下线的分类视为正常变化。

在线 API 演示

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

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

分类接口会返回什么?

它返回一个带有 storyType 数组的 JSON 对象。每个条目包含整数 id、名称和说明。由于没有记录到探测结果,这一数据结构来自提供的源示例,尚未经过验证。

这个操作需要任何参数吗?

不需要。用户不必提供路径、查询或必填请求头参数,一次 GET 请求就会返回全部分类列表,无需翻页。

如何使用分类 id?

从响应中取出你想要的分类的 id,传给按分类查询新闻列表的操作,即可获取该分类下的文章。不要把 id 写死在代码里,因为列表可能发生变化。

示例里出现了哪些分类?

源示例展示了 15 个条目:News、Editor's Picks、Editorial、Interviews、Specials、Reports、Previews、Statistics & Analysis、Live Blogs、Tour Diaries、Match Features、Features、Social Tattle、Premium Editorials 和 Pulse。

分类 id 是连续的吗?

不是。示例中的 id 为 1 到 8、10、13、18 到 21 以及 25。请用返回的取值建立对照表,不要去推测缺失的 id。

对所有用户和地区,这份列表都一样吗?

所提供的资料没有说明列表是否会因地区或时间而不同,所以请定期刷新,并以实际响应作为准绳。

响应里包含文章数量或链接吗?

源示例中没有。条目只带有 id、名称和说明,需要文章及其数量时,请使用新闻列表类操作。

相关接口

相关指南

查看订阅方案 →