媒体操作

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