媒体操作

图片上传(json)

POST /v1/medias/images?access_token={access_token}

请求头部: |请求头|说明 | |---|---| | Content-Type |application/json|

请求参数:

字段类型是否必填说明
access_tokenStringY访问令牌
file_nameStringY文件名称
file_contentbyte[]Y文件内容(BASE64)
file_digestStringN文件摘要,用于标记文件
file_typeStringN图片类型(例如:image/jpeg)
widthIntN图片宽度
heightIntN图片高度
qualityFloatN图片质量(取值范围:0-1)(默认值:1)
rotateFloatN图片旋转角度,默认0.0
formatStringN图片输入格式(默认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"
  }
}

错误返回值:

statusmessage说明
10011token 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_tokenStringY访问令牌
filenameStringY文件名称
file_contentStreamY文件流
file_digestStringN文件摘要,用于标记文件
file_typeStringN图片类型(例如:image/jpeg)
widthIntN图片宽度
heightIntN图片高度
qualityFloatN图片质量(取值范围:0-1)(默认值:1)
rotateFloatN图片旋转角度,默认0.0
formatStringN图片输入格式(默认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"
}

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在

文件上传(json)

POST /v1/medias?access_token={access_token}

请求头部:

请求头说明
Content-Typeapplication/json

请求参数:

字段类型是否必填说明
access_tokenStringY访问令牌
file_nameStringY文件名称
file_contentbyte[]Y文件内容
file_digestStringN文件摘要,用于标记文件

请求示例:

/v1/medias?access_token=b646339e2f4f4234af6bae5f72db9879
{
  "file_name" : "文件名称",
  "file_digest" : "文件摘要",
  "file_content" : "文件流",
  "file_metadata" : {
    "key1" : "value1"
  }
}

返回数据:

{
  "status": 0, 
  "message": "Everything is ok.", 
  "result": "Z3JvdXAxL00wMC8wMC8xMi9yQkFCRzFuSWpkdUFJVmE2QUFBQ0ZPcVh3eXM0MjMubXA0"
}

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在

文件上传(multipart/form-data)

POST /v1/medias?access_token={access_token}&file_digest={file_digest}&file_size={file_size}

请求参数:

字段类型是否必填说明
access_tokenStringY访问令牌
fileStreamY文件流(multipart/form-data)
file_digestStringY文件摘要,用于标记文件
file_sizelongY文件大小
filenameStringY文件名称
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"
}

错误返回值:

statusmessage说明
10011token not found.访问令牌不存在