按球队 ID 获取某支板球队的新闻报道列表
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →按必填的数字路径参数 `teamId`(默认值 2)返回与某一支板球队相关的新闻报道。teamId 取自球队列表接口返回的 `teamId` 字段。该接口不接受其他参数,现有资料也没有说明分页游标。此接口没有留存实际探测记录,下面的响应说明来自一份未经验证、且在 4,000 个字符处被截断的源示例。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)、`lastUpdatedTime` 字符串和 `storyList` 数组;对于默认的 teamId 2,示例里的 seoTitle 写的是印度队。`storyList` 的每个条目要么是 `story` 对象,要么是带有 `layout`、`name`、`position` 的 `ad` 广告位对象,所以客户端需要跳过广告位。单条报道包含 `id`(整数)、`hline`、`seoHeadline`、`intro`、`context`(示例中是访谈标签或巡回赛标签)、`storyType`(例如 Interviews 或 Previews)、`source`、`imageId`、`pubTime`(一串类似 epoch 的数字字符串,单位未说明)、空的 `adsType` 和 `entitlements` 对象,以及带有 `caption`、`id`、`source` 的 `coverImage`。在依赖这些内容之前,请用真实响应确认具体字段、返回的报道数量,以及某支球队没有报道时的表现。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/teams-get-news API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/teams-get-news?key=<API_KEY>&teamId=2'
查询结果
使用场景
- 在球队的赛程和战绩旁边搭建球队资讯面板,使用与赛程、阵容视图相同的 teamId,让整个球队页面的数据口径保持一致。
- 按 teamId 组装以球队为核心的编辑选题队列,避免用球队名称关键词收集无关文章,再通过新闻详情接口按 id 打开每条报道。
- 在球迷关注的球队出现新的报道 id 时发出通知,把每次轮询得到的 id 与上一次保存的集合做对比。
- 把某支球队近期的报道按 storyType 分组,为球迷应用或俱乐部风格的球迷主页生成访谈、前瞻等筛选标签。
- 为分析或梦幻板球研究看板提供即将进行的比赛中双方球队的最新标题,对每个 teamId 各调用一次该接口即可。
常见问题
球队新闻接口会返回什么?
返回某一支球队的新闻报道。此接口没有实际探测记录,数据结构来自一份被截断且未经验证的源示例:包含 appIndex 对象、lastUpdatedTime 字符串和 storyList 数组,数组条目是报道对象或广告占位对象。
有效的 teamId 从哪里获取?
使用球队列表接口返回的 teamId 字段。默认值 2 是参数说明里提供的示例 id,它对应的示例响应里页面标题写的是印度队,在界面上标注之前,请先在自己的球队响应里核对对应关系。
可以翻页查看某支球队更早的报道吗?
现有资料只记录了 teamId 这一个路径参数,没有分页游标。会返回多少条报道、能否取到更早的报道,需要用真实响应来确认。
为什么 storyList 里有些条目没有报道字段?
在源示例中,部分条目是带有 layout、name、position 的广告对象,而不是报道对象。构建文章卡片时,请跳过没有 story 键的条目。
怎样读取某条报道的全文?
每条报道都带有一个整数 id。把这个 id 传给新闻详情接口即可获取文章正文,因为本接口只返回标题、导语和封面图引用。
返回的报道一定都只与所请求的球队有关吗?
接口的定位是按球队查新闻,但资料没有说明报道是如何与球队匹配的。一条报道可能同时提到多支球队,在把它视为某支球队专属内容之前,请先阅读标题和上下文标签。
哪些响应字段是已验证的?
没有任何字段经过验证。此接口没有探测记录,源示例又在 4,000 个字符处被截断,所以字段名、类型和报道数量在你查看真实响应之前都不能视为已确认。
某支球队没有新闻时会怎样?
资料没有说明。请把缺失或为空的 storyList 当作正常结果处理,因为是否有报道取决于具体球队,界面上显示空状态即可,不要当作错误。