1. 媒体转换
2. 图片压缩
媒体转换
1. 媒体转换
GET
/v1/medias/{media_id}/translate?access_token={access_token}&source_type={source_type}&dest_type={dest_type}
请求头
请求头 |
说明 |
Content-Type |
application/json |
请求参数
字段 |
类型 |
是否必填 |
说明 |
access_token |
String |
Y |
访问令牌 |
media_id |
String |
Y |
待转换的媒体标识 |
source_type |
String |
Y |
源类型 |
dest_type |
String |
Y |
目标类型 |
特别说明
目前只支持:office转pdf pdf转图片 office转图片 amr转Mp3 其它转换不支持,请注意!!!
请求示例
office转图片:source_type=office&dest_type=jpg
/v1/medias/Z3JvdXAxL00wMC8wMi9FQi9yQkFDLUZoLTBibUVOWFluQUFBQUFBQUFBQUE0NjYudG1w/translate?source_type=office&dest_type=jpg&access_token=06bcdf9d4dab437ab46d35128a60b491
返回数据
application/json
字段 |
类型 |
说明 |
media_id |
String |
待转换的媒体标识 |
dest_ids |
List[String] |
转换后的媒体标识集合 |
name |
String |
媒体名称 |
{
"status": 0,
"message": "Everything is ok.",
"result": {
"media_id": "Z3JvdXAxL00wMC8wMC81Ni9yQkFDLUZmQUFuZUFlR1ZvQUF4RmNLS2xwQXMzNi5wcHR4",
"dest_ids": [
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FhSWFrQUFCNVZpSkdEdXMzOTkuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FPR01QQUFCeUxWcXhURWs2NDYuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FZdml0QUFCOFJ5dmZnaVE1NDEuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FTN25kQUFDVjU2QzMzb0ExMTguanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FHQ3FpQUFDVWw4bjVWdXMyMDUuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FlVHNBQUFCODBLOVBBRU05NDQuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FFLXRNQUFDVWpPT3Zkcm84NzYuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FVem5yQUFDSHFOM05BdUEyNzAuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FQeDkzQUFDU2x3OUU4Ums2MDIuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FiNmZFQUFDVEhKNjFIV2MxNjAuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FIYzBWQUFDVzRpdF91UVExOTUuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FHUHBsQUFDSzhna2g5RE03NzMuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FJaG4tQUFDRm1GelpzRE0wNTMuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FjX1JrQUFDZDFhdTNNd1kwNzMuanBn",
"Z3JvdXAxL00wMC8wMC9FMi9yQkFDLUZncXB2T0FRSENqQUFCbEY4ZThBQlkzNDQuanBn"
],
"name": "新版atwork技术架构.pptx",
"source_type": "office",
"dest_type": "jpg",
"create_time": 1479190247137,
"expire_time": 0
}
}
错误返回值
status |
message |
说明 |
10011 |
token not found. |
访问令牌不存在 |
2. 图片压缩
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码即可 |
特别说明
Content-type: multipart/form-data
请求示例
/v1/medias/compress?access_token=299abb50111349c5a347b510a4ab9ee1&thumb=true&original=true&digest=999
返回数据
application/json
字段 |
类型 |
说明 |
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编码的二进制流) |
{
"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
}
错误返回值
status |
message |
说明 |
10011 |
token not found. |
访问令牌不存在 |