上传下载多媒体文件
(→返回结果) |
|||
第59行: | 第59行: | ||
} | } | ||
</pre> | </pre> | ||
+ | |||
+ | 参数说明: | ||
+ | |||
+ | {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" | ||
+ | |- | ||
+ | !width="30%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|参数 | ||
+ | !width="70%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|描述 | ||
+ | {{api_args|type|媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb,主要用于视频与音乐格式的缩略图)}} | ||
+ | {{api_args|media_id|媒体文件上传后,获取时的唯一标识}} | ||
+ | {{api_args|created_at|媒体文件上传时间戳}} | ||
+ | |} | ||
2014年5月14日 (三) 16:26的版本
目录 |
上传下载多媒体文件
公众号在使用接口时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。通过本接口,公众号可以上传或下载多媒体文件。
文件上传接口
mss/media_upload
URL
http://upload.api.weibo.com/2/mss/media_upload.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
接口请求参数
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
type | true | string | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb) |
media | true | form-data中媒体文件标识,有filename、filelength、content-type等信息 |
相关约束
- 1、必须用Multipart/form-data方式
使用curl命令,用FORM表单方式上传一个多媒体文件:
curl -H "Authorization:OAuth2 USER_ACCESS_TOKEN" -F "media=@test.jpg"
“http://upload.api.weibo.com/2/mss/media_upload.json?type=TYPE”
- 2、上传的多媒体文件有格式和大小限制,如下:
• 图片(image):1MB,支持bmp,jpg,tiff,gif,pcx,tga,exif,fpx,svg,psd,cdr,pcd,dxf,ufo,eps,ai,png,raw格式
• 语音(voice):1MB,支持AMR\MP3格式
• 视频(video):2MB,支持MP4格式
• 缩略图(thumb):128K,支持bmp,jpg,tiff,gif,pcx,tga,exif,fpx,svg,psd,cdr,pcd,dxf,ufo,eps,ai,png,raw格式
返回结果
正确情况下的返回JSON数据包结果如下:
{ “type":"TYPE", "media_id":"MEDIA_ID", "created_at":123456789 }
参数说明:
参数 | 描述 | ||
---|---|---|---|
type | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb,主要用于视频与音乐格式的缩略图) | {{{3}}} | {{{4}}} |
media_id | 媒体文件上传后,获取时的唯一标识 | {{{3}}} | {{{4}}} |
created_at | 媒体文件上传时间戳 | {{{3}}} | {{{4}}} |
错误情况下的返回JSON数据包示例如下:
{ "error":"invalid media type", "error_code":20354, "request":"/2/mss/media_upload.json", "http_code":400 }