上传下载多媒体文件
(→相关约束) |
|||
| 第49行： | 第49行： | ||
• 缩略图（thumb）：128K，支持bmp,jpg,tiff,gif,pcx,tga,exif,fpx,svg,psd,cdr,pcd,dxf,ufo,eps,ai,png,raw格式 | • 缩略图（thumb）：128K，支持bmp,jpg,tiff,gif,pcx,tga,exif,fpx,svg,psd,cdr,pcd,dxf,ufo,eps,ai,png,raw格式 | ||
| + | |||
| + | ==返回结果== | ||
| + | 正确情况下的返回JSON数据包结果如下： | ||
| + | <pre> | ||
| + | { | ||
| + | “type":"TYPE", | ||
| + | "media_id":"MEDIA_ID", | ||
| + | "created_at":123456789 | ||
| + | } | ||
| + | </pre> | ||
| + | |||
| + | |||
| + | 错误情况下的返回JSON数据包示例如下： | ||
| + | <pre> | ||
| + | { | ||
| + | "error":"invalid media type", | ||
| + | "error_code":20354, | ||
| + | "request":"/2/mss/media_upload.json", | ||
| + | "http_code":400 | ||
| + | } | ||
| + | </pre> | ||
2014年5月14日 (三) 16:20的版本
目录 |
上传下载多媒体文件
公众号在使用接口时，对多媒体文件、多媒体消息的获取和调用等操作，是通过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
}
错误情况下的返回JSON数据包示例如下：
{
"error":"invalid media type",
"error_code":20354,
"request":"/2/mss/media_upload.json",
"http_code":400
}
