上传多媒体文件
请求方式: 使用multipart/form-data POST上传文件
请求地址: https://open.qingtui.com/v1/media/upload?access_token=ACCESS_TOKEN&type=TYPE
请求示例(使用curl命令,用FORM表单方式上传一个多媒体文件):
curl -F media=@test.jpg "https://open.qingtui.com/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 | 错误信息 |
备注:
上传的多媒体文件有格式和大小限制,如下:
- 图片(image): 300k,支持JPG/JPEG/PNG格式
- 文件(file):大小不超过30M,格式不限
- media_id是可复用的,暂无过期时间