跳转到: 导航, 搜索
 
(未显示2个用户的14个中间版本)
第1行: 第1行:
=视频上传服务OPEN API=
+
=视频上传 OPEN API=
==视频上传接口授权机制==
+
目前微博开放平台用户身份鉴权采用的是Oauth2.0,参见[http://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E 如何登录授权]
+
  
==视频上传基本流程==
+
<div class="wiki_txtJ">
微博提供视频分片上传服务,主要包含如下两个步骤:
+
微博为广大自媒体作者、机构、具备拍摄功能的硬件厂商等,提供短视频上传接口,可以将视频内容上传、并发布到微博。
init    初始化获取视频分片大小
+
upload  分片上传
+
  
视频大小和时长限制:
 
最大1G,时长15分钟
 
  
视频格式限制:
+
根据相关规定,视频服务需具备相关资质,因此需要接入的第三方是政务、媒体、机构等实体,个人暂时无法接入。
3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, m2ts, m4v, mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod, ts, vob, and wmv.
+
  
  
==视频上传初始化==
+
如果第三方需要与微博进行视频发布相关的接入合作,请联系 自己对应的蓝V客服、或政务运营进行咨询洽谈,开通视频上传接口并获取接口文档。
URL : https://api.weibo.com/2/proxy/media/init [GET]
+
  
说明:视频上传初始化,获取视频上传ID和分片大小
+
<div style="width:100%;display:table;margin-top:20px;">
 +
<div style="width:50%;display:table;float:left;">
 +
<div style="width:90%;height:50px;padding:10px;border:1px solid #CEE1EE;">
 +
<div style="width:50px;height:50px;float:left;"><img src="https://tva4.sinaimg.cn/crop.0.0.180.180.180/717f7411jw1eee33m060uj2050050glv.jpg" style="width:50px;height:50px;" /></div>
 +
<div style="float:left;margin-left:15px;">[http://weibo.com/openapi 微博开放平台]</div>
 +
</div>
 +
</div>
 +
</div>
  
参数:
+
</div>
  
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;"
 
|-
 
!width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段
 
!width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选
 
!width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型
 
!width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明
 
{{api_args|access_token|true|string|采用OAuth授权方式为必填参数,OAuth授权后获得}}
 
{{api_args|name|true|string|视频名称,必须带视频文件后缀}}
 
{{api_args|check|true|string|整个视频文件的md5}}
 
{{api_args|length|true|string|视频文件大小,单位字节}}
 
{{api_args|uid|true|string|微博用户uid}}
 
{{api_args|text|false|string|微博文本内容,必须做URLencode,内容不超过130个汉字,默认空时不发微博}}
 
{{api_args|visible|false|string|微博属性,0:公开发布,1:仅自己可见}}
 
{{api_args|cu|false|string|第三方可提供回调接口,用于视频上传转码之后通知,默认空}}
 
{{api_args|ua|false|string|用户ua属性}}
 
|}
 
  
返回:
 
  
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;"
+
__NOTOC__
|-
+
{{#a:nobtns|noheading}}
!width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段
+
!width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选
+
!width="75%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明
+
{{rdes_args|res|string|成功或失败,true或false}}
+
{{rdes_args|uploadId|string|视频上传ID}}
+
{{rdes_args|length|string|视频分片大小,单位字节}}
+
|}
+
 
+
示例:
+
 
+
<pre>
+
{
+
  res : true
+
  uploadId : 1425623419.093.de1f9ded7911efac25c137bccf1a4019.r11
+
  length : 256000
+
}
+
</pre>
+
 
+
==视频文件上传==
+
URL : https://api.weibo.com/2/proxy/media/upload [GET/POST]
+
 
+
说明:视频分片上传
+
 
+
参数:
+
 
+
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;"
+
|-
+
!width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段
+
!width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选
+
!width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型
+
!width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明
+
{{api_args|access_token|true|string|采用OAuth授权方式为必填参数,OAuth授权后获得}}
+
{{api_args|uploadId|true|string|视频上传ID}}
+
{{api_args|sliceCheck|true|string|视频分片的md5}}
+
{{api_args|content|true|string|视频分片数据,放在postfield中}}
+
|}
+
 
+
返回:
+
 
+
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;"
+
|-
+
!width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段
+
!width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选
+
!width="75%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明
+
{{rdes_args|res|string|成功或失败,true或false}}
+
{{rdes_args|partNumber|string|视频分片编号,从1开始}}
+
{{rdes_args|fid|string|视频对象ID,最后一个分片上传成功之后才返回}}
+
|}
+
 
+
示例:
+
 
+
<pre>
+
{
+
  res : true
+
  partNumber : 1
+
  fid : 1034:7588a824bf75c8c1dc263450dc324c2b (最后一个分片上传成功后才返回)
+
}
+
</pre>
+
 
+
==错误代码==
+
 
+
错误码
+
 
+
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;"
+
|-
+
!width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|错误码
+
!width="40%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|错误msg
+
!width="45%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|描述
+
{{rdes_args|20001|post param loss|post参数缺失}}
+
{{rdes_args|20002|get param loss|get参数缺失}}
+
|}
+

2022年11月29日 (二) 11:46的最后版本

视频上传 OPEN API

微博为广大自媒体作者、机构、具备拍摄功能的硬件厂商等,提供短视频上传接口,可以将视频内容上传、并发布到微博。


根据相关规定,视频服务需具备相关资质,因此需要接入的第三方是政务、媒体、机构等实体,个人暂时无法接入。


如果第三方需要与微博进行视频发布相关的接入合作,请联系 自己对应的蓝V客服、或政务运营进行咨询洽谈,开通视频上传接口并获取接口文档。




文档更新时间: 2022-11-29