微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
=上传下载多媒体文件= 公众号在使用接口时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。通过本接口,公众号可以上传或下载多媒体文件。 ==文件上传接口== mss/media_upload ==URL== http://upload.api.weibo.com/2/mss/media_upload.json ==支持格式== JSON ==HTTP请求方式== POST ==是否需要登录== 是<br/> 关于登录授权,参见 [[授权机制说明|如何登录授权]] ==接口请求参数== {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" |- !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|参数 !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|必选 !width="10%" 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|source|true|string|申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)}} {{api_args|type|true|string|媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb)}} {{api_args|media|true| |form-data中媒体文件标识,有filename、filelength、content-type等信息}} |} ==相关约束== *1、必须用Multipart/form-data方式 <pre> 使用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” </pre> *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数据包结果如下: <pre> { “type":"TYPE", "media_id":"MEDIA_ID", "created_at":123456789 } </pre> 参数说明: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" |- !width="20%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|参数 !width="80%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|描述 |- |style="border:1px solid #cccccc;text-align:center"| type |style="border:1px solid #cccccc;text-align:left"| 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb,主要用于视频与音乐格式的缩略图) |- |style="border:1px solid #cccccc;text-align:center"| media_id |style="border:1px solid #cccccc;text-align:left"| 媒体文件上传后,获取时的唯一标识 |- | style="border:1px solid #cccccc;text-align:center"|created_at |style="border:1px solid #cccccc;text-align:left"| 媒体文件上传时间戳 |} 错误情况下的返回JSON数据包示例如下: <pre> { "error":"invalid media type", "error_code":20354, "request":"/2/mss/media_upload.json", "http_code":400 } </pre> =下载多媒体文件= 公众号在使用接口时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。通过本接口,公众号可以上传或下载多媒体文件。 ==文件下载接口== mss/msget ==URL== http://upload.api.weibo.com/2/mss/media_msget.json ==支持格式== JSON ==HTTP请求方式== GET ==是否需要登录== 是<br/> 关于登录授权,参见 [[授权机制说明|如何登录授权]] ==接口请求参数== {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" |- !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|参数 !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|必选 !width="10%" 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|source|true|string|申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)}} {{api_args|media|true| |媒体文件ID}} |} ==调用示例== <pre> http请求方式: GET http://upload.api.weibo.com/2/mss/media_msget.json?source=xxx&media_id=MEDIA_ID 请求示例(示例为通过curl命令获取多媒体文件) curl -I -G "http://upload.api.weibo.com/2/mss/media_msget.json?source=xxx&media_id=MEDIA_ID" </pre> ==返回结果== 正确情况下返回的HTTP头如下: <pre> HTTP/1.1 200 OK Connection: close Content-Type: image/jpeg Content-disposition: attachment; filename="MEDIA_ID.jpg" Date: Sun, 06 Jan 2013 10:20:18 GMT Cache-Control: no-cache, must-revalidate Content-Length: 339721 curl -G "http://upload.api.weibo.com/2/mss/media_msget.json?source=xxx&media_id=MEDIA_ID" </pre> 错误情况下的返回JSON数据包示例如下: <pre> { "request":"\/file\/attachment\/real_url.json", "err_code":3,"err_msg":"file is non-existent" } </pre>
该页面使用的模板:
模板:Api args
(
查看源代码
)
返回到
上传下载多媒体文件
。
反馈
分享
顶部