上传多媒体文件

优质
小牛编辑
208浏览
2023-12-01

请求方式: 使用multipart/form-data POST上传文件

请求地址: https://open.qingtui.cn/v1/media/upload?access_token=ACCESS_TOKEN&type=TYPE

请求示例(使用curl命令,用FORM表单方式上传一个多媒体文件):

curl -F media=@test.jpg "https://open.qingtui.cn/v1/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

参数说明:

参数必须说明
access_token调用接口凭证
type媒体文件类型,暂时仅支持图片(image)和文件(file)

正确返回结果示例:

{
   "type":"TYPE",
   "media_id":"MEDIA_ID",
   "created_at":"0123456789123"
}

出错返回结果示例:

{
    "errcode": 40005,
    "errmsg": "不合法的文件类型"
}

参数说明:

参数说明
type媒体文件类型,支持图片(image)和文件(file)
media_id媒体文件上传后,获取时的唯一标识
created_at媒体文件上传时间戳
errcode错误代号
errmsg错误信息

备注:
上传的多媒体文件有格式和大小限制,如下:

  1. 图片(image): 3M,支持JPG/JPEG/PNG格式
  2. 文件(file):大小不超过30M,格式不限
  3. media_id是可复用的,暂无过期时间