图片圆角处理(roundPic)
roundPic 将图片生成圆角图片,并且可以指定图片的圆角大小。这个接口支持的原图片格式有png
、jpg
,处理后的图片格式为png
。
注意:处理前的图片大小不能超过20M。
接口规格
注意:接口规格不含任何空格与换行符。
roundPic/radius/<radius>
/radiusx/<radiusx>
/radiusy/<radiusy>
参数名称 | 必填 | 说明 |
---|---|---|
/radius/<radius> |
否 | 圆角大小的参数,水平和垂直的值相同,可以使用像素数(如200)或百分比(如!25p)。不能与radiusx 和radiusy 同时使用。 |
/radiusx/<radiusx> |
否 | 圆角水平大小的参数,可以使用像素数(如200)或百分比(如!25p)。需要与radiusy 同时使用。 |
/radiusy/<radiusy> |
否 | 圆角垂直大小的参数,可以使用像素数(如200)或百分比(如!25p)。需要与radiusx 同时使用。 |
注意:
1.其中当像素数大于宽(高)的1/2时取其1/2,百分比大于!50p时,取!50p;
2.像素数与百分比均需为非负值,命令roundPic/radius/!50p可使方形图片变圆。
请求报文
请求语法
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字符串(已格式化,便于阅读):
{
"error": "invalid roundPic command"
}
字段名称 | 必填 | 说明 |
---|---|---|
code | 是 | HTTP状态码,请参考响应状态码 |
error | 是 | 与HTTP状态码对应的消息文本 |
响应状态码
HTTP状态码 | 含义 |
---|---|
200 | 缩略成功 |
400 | 请求报文格式错误 |
404 | 资源不存在 |
599 | 服务端操作失败。 如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。 |
示例
- 把一张图片变成圆角:
http://dn-odum9helk.qbox.me/resource/gogopher.jpg?roundPic/radius/50
文档反馈
(如有产品使用问题,请提交工单)