1. 图片上传（json）
2. 图片上传（multipart/form-data方式）
3. 文件上传（json）
4. 文件上传（multipart/form-data方式）
媒体操作
1. 图片上传（json）
POST
/v1/medias/images?access_token={access_token}
请求头
| 请求头 |
说明 |
| Content-Type |
application/json |
请求参数
| 字段 |
类型 |
是否必填 |
说明 |
| access_token |
String |
Y |
访问令牌 |
| file_name |
String |
Y |
文件名称 |
| file_content |
byte[] |
Y |
文件内容(BASE64) |
| file_digest |
String |
N |
文件摘要,用于标记文件 |
| file_type |
String |
N |
图片类型（例如:image/jpeg） |
| width |
Int |
N |
图片宽度 |
| height |
Int |
N |
图片高度 |
| quality |
Float |
N |
图片质量（取值范围：0-1）（默认值：1） |
| rotate |
Float |
N |
图片旋转角度,默认0.0 |
| format |
String |
N |
图片输入格式(默认jpg) |
请求示例
/v1/medias/images?access_token=b646339e2f4f4234af6bae5f72db9879
{
"file_name" : "文件名称",
"file_type" : "图片格式用于读取时响应的Content-Type"
"file_digest" : "文件摘要",
"file_content" : "文件内容",
"width" : 100,
"height" : 100,
"rotate" : 0,
"quality" : 0.6,
"format" : "jpg"
}
返回数据
{
"status": 0,
"message": "Everything is ok.",
"result": {
"Z3JvdXAxL00wMC8wMC8wMC9yQkFCR1ZoSGlGeUFkNWowQUFENXFPZDZ6LW8wMDguZ2lm"
}
}
错误返回值
| status |
message |
说明 |
| 10011 |
token not found. |
访问令牌不存在 |
POST
/v1/medias/images?access_token={access_token}&file_digest={file_digest}&file_size={file_size}&width={width}&heigh={heigh}&rotate={heigh}&quality={quality}&format={format}
请求参数
| 字段 |
类型 |
是否必填 |
说明 |
| access_token |
String |
Y |
访问令牌 |
| filename |
String |
Y |
文件名称 |
| file_content |
Stream |
Y |
文件流 |
| file_digest |
String |
N |
文件摘要,用于标记文件 |
| file_type |
String |
N |
图片类型（例如:image/jpeg） |
| width |
Int |
N |
图片宽度 |
| height |
Int |
N |
图片高度 |
| quality |
Float |
N |
图片质量（取值范围：0-1）（默认值：1） |
| rotate |
Float |
N |
图片旋转角度,默认0.0 |
| format |
String |
N |
图片输入格式(默认jpg) |
POST /medias/images?access_token={access_token}&file_digest=文件摘要&file_size=文件大小&width=图片剪裁的宽度&heigh=图片剪裁的高度&rotate=图片旋转角度&quality=图片压缩率(0~1)&format=图片输入格式(默认jpg)
Content-Type: multipart/form-data
Accept: application/json
------------boundary
Content-Disposition:form-data; name="file";filename=""
Content-Type: {content-type}
file content...
返回数据
{
"status": 0,
"message": "Everything is ok.",
"result": "Z3JvdXAxL00wMC8wMC8xMi9yQkFCR1ZuSWkxU0FINl9LQUFGeTNEQzlfYUEyOTQuanBn"
}
错误返回值
| status |
message |
说明 |
| 10011 |
token not found. |
访问令牌不存在 |
3. 文件上传（json）
POST
/v1/medias?access_token={access_token}
请求头
| 请求头 |
说明 |
| Content-Type |
application/json |
请求参数
| 字段 |
类型 |
是否必填 |
说明 |
| access_token |
String |
Y |
访问令牌 |
| file_name |
String |
Y |
文件名称 |
| file_content |
byte[] |
Y |
文件内容 |
| file_digest |
String |
N |
文件摘要,用于标记文件 |
请求示例
/v1/medias?access_token=b646339e2f4f4234af6bae5f72db9879
{
"file_name" : "文件名称",
"file_digest" : "文件摘要",
"file_content" : "文件流",
"file_metadata" : {
"key1" : "value1"
}
}
返回数据
{
"status": 0,
"message": "Everything is ok.",
"result": "Z3JvdXAxL00wMC8wMC8xMi9yQkFCRzFuSWpkdUFJVmE2QUFBQ0ZPcVh3eXM0MjMubXA0"
}
错误返回值
| status |
message |
说明 |
| 10011 |
token not found. |
访问令牌不存在 |
POST
/v1/medias?access_token={access_token}&file_digest={file_digest}&file_size={file_size}
请求参数
| 字段 |
类型 |
是否必填 |
说明 |
| access_token |
String |
Y |
访问令牌 |
| file |
Stream |
Y |
文件流（multipart/form-data） |
| file_digest |
String |
Y |
文件摘要,用于标记文件 |
| file_size |
long |
Y |
文件大小 |
| filename |
String |
Y |
文件名称 |
POST /medias?access_token={access_token}&file_digest=文件摘要&file_size=文件大小
Content-Type: multipart/form-data
Accept: application/json
------------boundary
Content-Disposition:form-data; name="file";filename=""
Content-Type: {content-type}
file content...
返回数据
{
"status": 0,
"message": "Everything is ok.",
"result": "Z3JvdXAxL00wMC8wMC8xMi9yQkFCRzFuSWpkdUFJVmE2QUFBQ0ZPcVh3eXM0MjMubXA0"
}
错误返回值
| status |
message |
说明 |
| 10011 |
token not found. |
访问令牌不存在 |