按图集 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 用户在图集列表中选中某个图集后,传入其 galleryId 打开详情,再渲染标题、导语,以及由各 imageId 构成的照片网格。
- 搭建编辑选图视图,把每条图片说明与它的 imageId 并列展示,并在发布之前另行核对使用权限和图片是否可用。
- 读取 tags 数组中的 match 类型标签,并把它的 itemId 与你已展示的比赛对应起来,从而把比赛图集挂到比赛页面上。
- 收集 tags 中包含某个球队或赛事 itemId 的图集,再按 publishedTime 排序,搭建球队或赛事的图集专区。
- 制作带说明的幻灯片或社交分享卡片草稿,每一页都把一条 caption 文字与通过其 imageId 取得的图片配对。
常见问题
图集接口会返回什么?
返回单个图集。由于没有留存探测记录,响应结构来自未经验证的源示例:包含 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 数组为空或缺失的情形。