获取板球图集列表,返回标题、封面图 ID 和发布时间,支持 pt 游标翻页

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

返回板球图集索引,示例数据按从新到旧排列,适合先渲染图集宫格,再根据图集 ID 打开某一个图集。唯一的输入是可选的数字型查询参数 `pt`,它是翻页游标:留空即加载第一页,翻页时传入本接口上一次返回的最后一个图集的 `publishedTime` 值即可加载下一页。该接口没有记录过实时探测结果,响应说明来自一份未经验证的来源示例。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)和一个含 11 个条目的 `photoGalleryInfoList` 数组。每个条目要么是 `photoGalleryInfo` 对象,要么是带有 `layout`、`name`、`position` 的 `ad` 广告占位对象,因此客户端需要跳过广告位。图集信息包含 `galleryId`(整数)、`headline`(标题)、`imageId`(整数)、`publishedTime`(由类似时间戳的数字组成的字符串,时间单位未说明),多数条目还带有 `imageHash` 字符串。在依赖这些内容之前,请用真实响应确认具体字段、每页数量、排序方式,以及游标翻到末尾后返回什么。

API 功能

一次 GET 取得图集索引 无需任何必填参数,一次请求就能拿到图集索引,因此不必事先知道比赛、球队或系列赛标识,也能填充图片频道的首页。
图集 ID 用于详情查询 每个 photoGalleryInfo 条目都带有整数 galleryId。客户端可以把这个值带到图集详情接口,加载所选图集里的全部图片。
标题与封面图引用 示例中每个图集都有 headline 标题和整数 imageId,多数条目还有 imageHash。这些字段足够渲染带标题的卡片,并通过图片接口取得封面图。
基于 publishedTime 的翻页游标 可选参数 pt 接收你收到的最后一个图集的 publishedTime。第一页留空,之后传入最新的游标即可沿着索引继续向后翻。
广告位单独标记 示例列表把 photoGalleryInfo 条目和带有 layout、name、position 的 ad 对象混在一起,客户端只要检查条目使用的键,就能把占位项过滤掉。
页面标题与链接 示例里的 appIndex 对象包含图片频道的 seoTitle 和 webURL 字符串,可以作为图集宫格上方的标题或参考链接。

在线 API 演示

GET /api/project/cricbuzz-cricket/images-list-galleries

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

图集列表接口返回什么?

它返回板球图集索引。由于没有记录过探测结果,数据结构来自一份未经验证的来源示例:一个 appIndex 对象和一个 photoGalleryInfoList 数组,数组条目是 photoGalleryInfo 对象(galleryId、headline、imageId、publishedTime,通常还有 imageHash)或广告占位项。

如何用 pt 参数加载下一页?

第一页让 pt 留空。要加载下一页,请传入本接口上一次返回的最后一个图集的 publishedTime 值。它是游标而不是页码,所以传 2 或 3 并不是文档中说明的翻页方式。

如何打开某个图集里的图片?

本接口只负责列出图集。请从条目中取出 galleryId,并传给目录中的图集详情接口。列表里的 imageId 指向封面图,可以用图片接口获取。

为什么有些列表条目是 ad 对象而不是图集?

来源示例中有些条目只含 layout、name 和 position 字段,没有 photoGalleryInfo。它们看起来是广告位标记,客户端应跳过没有 photoGalleryInfo 键的条目,而不要把它们当作空图集。

publishedTime 可以直接解析成日期吗?

示例中它是一串类似毫秒级时间戳的数字字符串,但时间单位没有文档说明,也没有探测结果可以确认。转换成日期之前请先用真实响应核对,并在把它作为 pt 游标复用时保留原始字符串。

相关接口

相关指南

查看订阅方案 →