按图片 ID 获取板球图片,可选画质(d)和尺寸(p)参数。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →按 ID 请求一张板球图片。路径参数 imageId 为必填的字符串:取其他接口(例如球员资料)提供的数字图片 ID,并在前面加上字母 c,默认值为 c231889。文档中有两个可选的查询参数:d 可取 high 或 low,p 用于指定图片尺寸,可取 de、det、gthumb 或 thumb。源文本没有说明各个取值在视觉上有什么区别,所以请对计划使用的选项自行测试。路径以 i.jpg 结尾,因此请求指向的是 JPEG 图片资源,而不是 JSON 文档。目前提供的探测记录中没有观察到该接口的实际响应,唯一提供的响应示例是一个空对象,所以每种 d 与 p 取值对应的返回内容类型、字节大小和像素尺寸都没有经过验证。请把图片 ID 当作与提供它的接口之间的关联键保留下来,并在产品中使用某张图片之前,确认你有权发布它。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/images-get-image API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/images-get-image?key=<API_KEY>&imageId=c231889'
查询结果
使用场景
- 把球员资料提供的整数图片 ID 转换成图片请求,并将该 ID 保留为关联键。
- 在获准的范围内渲染球员或编辑用图片,同时在发布前校验可选的 d、p 取值以及图片使用权。
- 为紧凑的球员名单行测试 thumb 与 gthumb,在球员详情页使用更大的预设,然后保留在你的版面中效果最好的一种。
- 在慢速移动网络环境下,自行对比 d=low 与 d=high,再决定轻量的应用视图应当请求哪一种。
- 对已保存的图片 ID 运行巡检任务,记录哪些 ID 能够正常获取,在图集或球队阵容页上线前发现失效的头像。
常见问题
如何构造 imageId 的值?
取其他接口(例如球员资料)提供的数字图片 ID,并在前面加上字母 c。默认值 c231889 展示了这种格式。该 ID 作为字符串路径段传入。
d 和 p 参数可以取哪些值?
d 为可选参数,文档中的取值是 high 或 low。p 为可选参数,用于指定图片尺寸,文档中的取值是 de、det、gthumb 或 thumb 之一。两者都可以省略,列表以外的取值没有文档说明。
该接口会返回什么?
路由以 i.jpg 结尾,且操作被描述为按 ID 获取图片,所以应当预期得到的是图片资源而不是 JSON。唯一提供的响应示例是一个空对象,因此返回结果的内容类型和大小没有经过验证。
这些行为是在探测中观察到的吗?
不是。提供的探测记录中没有观察到该接口的响应。参数取值来自接口文档,每个 d 和 p 取值的实际效果请用自己的请求确认。
图片 ID 从哪里获取?
来自带有图片标识的其他接口响应,例如球员资料。请在你的数据模型中把该来源 ID 与生成的图片地址放在一起保存,这样就能把图片追溯到提供它的记录。
返回的图片都可以公开发布吗?
请不要想当然地这样认为。技术上能够请求图片,并不代表获得了再分发的权利。在公开展示球员或编辑图片之前,请先核对适用于你产品的图片使用条款。
图片加载失败时应该怎么办?
先确认 ID 带有 c 前缀,再去掉 d 和 p 重试,并在界面中回退到占位头像。图片的覆盖范围取决于具体的 ID,文档也没有说明错误响应体的格式。