图片基本处理(imageView)
描述
imageView是七牛云存储提供的一种简易却强大的图片处理接口,只需要填写少数几个参数即可对图片进行缩放操作,生成各种缩略图。
本接口不再进行功能扩展,建议开发者使用新的imageView2接口。
接口规格
注意:接口规格不含任何空格与换行符,下列内容经过格式化以便阅读。
imageView/<mode>
/w/<width>
/h/<height>
/q/<quality>
/format/<format>
参数名称 | 必填 | 说明 |
/<mode> |
是 | 图像缩放处理模式 |
/w/<width> |
目标图片的宽度,单位:像素(px) | |
/h/<height> |
目标图片的高度,单位:像素(px) | |
/q/<quality> |
目标图片的图像质量,取值范围:1-100,缺省为85 | |
/format/<format> |
目标图片的输出格式,取值范围:jpg,gif,png,webp等,缺省为原图格式 |
其中 <mode>
分为如下几种情况:
模式 | 说明 |
<mode>=1 |
同时指定宽度和高度,等比裁剪原图正中部分并缩放为 |
<mode>=2 |
同时指定宽度和高度,原图缩小为不超出 |
<mode>=2 |
仅指定宽度,高度等比缩小 |
<mode>=2 |
仅指定高度,宽度等比缩小 |
请求
请求报文格式
GET <imageDownloadURI>?<接口规格> HTTP/1.1
Host: <imageDownloadHost>
请求头部
头部名称 | 必填 | 说明 |
Host | 是 | 下载服务器域名,可为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程 |
响应
响应报文格式
HTTP/1.1 200 OK
Content-Type: <imageMimeType>
<imageBinaryData>
响应头部
头部名称 | 必填 | 说明 |
Content-Type | 是 | MIME类型,成功时为图片的MIME类型,失败时为application/json |
Cache-Control | 缓存控制,失败时为no-store,不缓存 |
响应内容
■ 如果请求成功,返回图片的二进制数据。
■ 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"code": <httpCode int>,
"error": "<errMsg string>",
}
字段名称 | 必填 | 说明 |
code |
是 | HTTP状态码,请参考响应状码 |
error |
是 | 与HTTP状态码对应的消息文本 |
响应状态码
HTTP状态码 | 含义 |
200 | 缩放成功 |
400 | 请求报文格式错误 |
404 | 资源不存在 |
599 | 服务端操作失败。 如遇此错误,请将完整错误信息(包括所有HTTP响应头部)通过邮件发送给我们。 |
附注
- imageView生成的图片会被七牛云存储缓存以加速下载,但不会持久化。需要持久化的缩略图,请参考触发持久化处理和saveas处理。
- 如果原图带有EXIF信息且包含
Orientation
字段,imageView缺省根据此字段的值进行自动旋转修正。
示例
裁剪正中部分,等比缩小生成200x200缩略图:
http://developer.qiniu.com/resource/gogopher.jpg?imageView2/1/w/200/h/200
裁剪正中部分,等比放大生成500x500放大图:
http://developer.qiniu.com/resource/gogopher.jpg?imageView/1/w/500/h/500
宽度固定为200px,高度等比缩小,生成200x133缩略图:
http://developer.qiniu.com/resource/gogopher.jpg?imageView2/2/w/200
高度固定为200px,宽度等比缩小,生成300x200缩略图:
http://developer.qiniu.com/resource/gogopher.jpg?imageView2/2/h/200
如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询