按图集 ID 获取单个板球图集,含标题、图片说明、图片 ID 与标签

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

返回单个板球图集的详情,通过必填的数字型路径参数 `galleryId`(默认 5374)来选定。galleryId 取自图集列表接口。该接口不接受其他参数。没有留存实际探测记录,因此响应说明来自所提供的未经验证的源示例。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)、`headline` 字符串、`intro` 字符串、`photoGalleryDetails` 数组、与所请求图集 ID 一致的整数 `photoId`、由类似时间戳的数字组成的 `publishedTime` 字符串(单位文档未说明)、`state` 字符串(示例中为 `Published`)以及 `tags` 数组。`photoGalleryDetails` 的每个条目包含 `caption` 字符串和整数 `imageId`;条目中不带图片 URL,所以图片本身需要用每个 imageId 再通过图片接口单独获取。`tags` 的每个条目包含 `itemId`(字符串)、`itemName` 和 `itemType`,示例中使用 team、series 和 match 三种类型,把图集关联到球队、赛事和具体比赛。示例图集对应一场联赛比赛,共有八张带说明的照片。在依赖这些信息之前,请用实际响应确认准确的字段集合、照片数量、标签类型,以及传入未知或未发布的 galleryId 时的结果。

API 功能

一个 galleryId 对应一个图集 只需一次 GET 请求并传入 galleryId 路径参数,就能在一个响应里拿到整个图集,图集页面无需拼接多次调用的结果来凑齐照片。
图集 ID 来自图集列表 galleryId 是图集列表接口返回的标识。表单预填了 5374,也可以换成列表中的其他图集 ID。
图片说明与图片 ID 成对出现 源示例中,photoGalleryDetails 为每张照片提供一条 caption 和一个 imageId,替代文字与照片标识一同返回,可以并排存储。
可直接用于图片接口的 imageId 条目里只有 imageId 数值而没有 URL。把每个 imageId 传给图片接口,就能按所选尺寸获取实际图片,图集元数据与图片获取因此是两个独立的步骤。
球队、赛事和比赛标签 示例中的 tags 数组通过 itemType、itemId 和 itemName 把图集关联到球队、赛事和具体比赛,便于按读者关注的对象筛选图集。
标题、导语与发布状态 headline 和 intro 提供图集标题,publishedTime 记录上线时间,state 显示发布状态(示例中为 Published),可用来隐藏未标记为已发布的内容。

在线 API 演示

GET /api/project/cricbuzz-cricket/images-get-gallery

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

图集接口会返回什么?

返回单个图集。由于没有留存探测记录,响应结构来自未经验证的源示例:包含 appIndex 对象、headline、intro、由 caption 与 imageId 条目组成的 photoGalleryDetails 数组、photoId、publishedTime、state 以及 tags 数组。

有效的 galleryId 从哪里获取?

使用图集列表接口返回的 galleryId。默认值 5374 只是参数说明中提供的示例 ID,请先在自己的列表响应中确认它对应哪个图集,再为它命名。

响应里包含图片 URL 吗?

所提供的示例中没有。photoGalleryDetails 的条目只有 caption 和 imageId。要显示图片,请把 imageId 传给图片接口,它会按标识返回图片。

标签描述的是什么?

每个标签都有 itemId、itemName 和 itemType。示例使用 team、series 和 match 三种类型,把图集关联到球队、赛事和具体比赛。其中 itemId 是字符串,请先确认自己系统中 ID 的存储方式,再决定是否转换。

photoId 和 galleryId 是同一个值吗?

在源示例中,photoId 等于所请求的图集 ID(5374)。请把它视为示例而非保证,并以你发送的 ID 作为自己记录的主键。

publishedTime 使用什么单位?

示例给出的是一串看起来像时间戳的数字字符串,但文档没有说明单位。转换之前,请先拿几个值与已知的发布日期做比对。

可以在自己的网站上复用这些照片吗?

响应只记录了图片说明和图片标识,并没有说明任何授权或再分发权利,所以请与内容所有者单独确认图片的使用权限,不要把这些数据当作授权依据。

如果图集里没有照片,或者 ID 不存在会怎样?

现有资料没有覆盖这种情况,也没有留存探测记录。请用实际响应测试未知的 galleryId,并在客户端中处理 photoGalleryDetails 数组为空或缺失的情形。

相关接口

相关指南

查看订阅方案 →