图片压缩
图片压缩
POST /v1/medias/compress?access_token={access_token}&width={width}&height={height}&quality={quality}&format={format}&thumb={thumb}&thumb_width={thumb_width}&thumb_height={thumb_height}&thumb_size={thumb_size}&original={original}
请求头部:
请求头 | 说明 |
---|---|
Content-Type | multipart/form-data |
请求参数:
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
access_token | String | Y | 访问令牌 |
media | Stream | Y | 待压缩的图片流(multipart/form-data) |
width | Int | N | 压缩后的图片宽度(默认值:800) |
height | Int | N | 压缩后的图片高度(默认值:800) |
quality | Float | N | 压缩后的图片质量(取值范围:0-1)(默认值:1) |
format | String | N | 压缩后的图片类型(默认值:JPG) |
thumb | Boolean | N | 是否需要缩略图(默认值:false) |
thumb_width | Int | N | 缩略图宽度(默认值:180) |
thumb_height | Int | N | 缩略图高度(默认值:180) |
thumb_size | Int | N | 缩略图大小(默认值:20480字节) |
original | Boolean | N | 是否保存原文件(默认值:false) |
digest | String | N | 文件签名,一般采用MD5码即可 |
请求示例:
/v1/medias/compress?access_token=299abb50111349c5a347b510a4ab9ee1&thumb=true&original=true&digest=999
返回数据:
点击查看响应数据
{
"message": "Everything is ok.",
"result": {
"original_media": {
"media_id": "Z3JvdXAxL00wMC8wMC8wRS9yQkFCR1ZrLU8tbUFhMWZsQUFHODJTNURYMGszODAuanBn",
"size": 113881,
"width": 0,
"height": 0
},
"media": {
"height": 208,
"media_id": "Z3JvdXAxL00wMC8wMC8wMC9yQkFCR1ZoSGlGeUFkNWowQUFENXFPZDZ6LW8wMDguZ2lm",
"size": 63912,
"width": 208
},
"thumb_media": {
"blob": "Base64 encode data",
"height": 180,
"media_id": "Z3JvdXAxL00wMC8wMC8wMC9yQkFCRzFoSGgydUFMZnhzQUFBWDBCeEJlbUUxMjcuanBn",
"size": 6096,
"width": 180
}
},
"status": 0
}
字段 | 类型 | 说明 |
---|---|---|
media.height | Int | 图片高度 |
media.width | Int | 图片宽度 |
media.size | Int | 图片大小 |
media.media_id | String | 图片媒体标识 |
thumb_media.height | Int | 缩略图片高度 |
thumb_media.width | Int | 缩略图片宽度 |
thumb_media.size | Int | 缩略图片大小 |
thumb_media.media_id | String | 缩略图片媒体标识 |
thumb_media. blob | String | 缩略图片(经Base64编码的二进制流) |
错误返回值:
status | message | 说明 |
---|---|---|
10011 | token not found. | 访问令牌不存在 |