# 媒体操作

# 图片上传(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. 访问令牌不存在

# 图片上传(multipart/form-data)

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. 访问令牌不存在

# 文件上传(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. 访问令牌不存在

# 文件上传(multipart/form-data)

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. 访问令牌不存在