Weibo Platform Logo

微博开放平台

weibo

Video/thirdapi

跳转到： 导航, 搜索
 
（未显示1个用户的7个中间版本）
第3行： 第3行：
 
微博平台支持第三方视频网站地址分享到微博后，以视频形式展示给用户。当分享到微博后，微博平台会识别第三方URL域名，通过回调其提供的接口，获取该URL的信息并做保存，最后带有该URL的微博会以视频形式展现给用户。
 
微博平台支持第三方视频网站地址分享到微博后，以视频形式展示给用户。当分享到微博后，微博平台会识别第三方URL域名，通过回调其提供的接口，获取该URL的信息并做保存，最后带有该URL的微博会以视频形式展现给用户。
 
==开发者接入步骤==
 
==开发者接入步骤==
−
（2.1）申请成为微博平台开发者。详见新手指南
+
（2.1）申请成为微博平台开发者。[http://open.weibo.com/wiki/%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97 详见新手指南]
 +
 
 
（2.2）提供第三方URL域名。
 
（2.2）提供第三方URL域名。
 +
 
（2.3）提供视频信息回调接口。 详见下文
 
（2.3）提供视频信息回调接口。 详见下文
 +
 
（2.4）视频信息若有变动，需主动调用微博接口更新该视频信息。 详见下文
 
（2.4）视频信息若有变动，需主动调用微博接口更新该视频信息。 详见下文
 +
 
（2.5）开发联调，测试上线。
 
（2.5）开发联调，测试上线。
 +
 
==第三方视频信息回调接口==
 
==第三方视频信息回调接口==
 
URL : http://***.com/***?url=***
 
URL : http://***.com/***?url=***
 +
 
说明：由第三方提供该回调接口，返回完整的JSON格式的视频对象信息，参数url为透传第三方分享到微博的链接地址url
 
说明：由第三方提供该回调接口，返回完整的JSON格式的视频对象信息，参数url为透传第三方分享到微博的链接地址url
−
视频对象信息说明：
+
 
 +
<b>视频对象信息说明：</b>
 +
<center>
 +
<table class="wiki_table" border="0" cellspacing="0" cellpadding="0">
 +
 
 +
<tr>
 +
<th class="wiki_table_thfirst" scope="col" width="25%">对象一级字段</th>
 +
<th scope="col" width="20%">二级字段</th>
 +
<th scope="col" width="55%">字段说明</th>
 +
</tr>
 +
 
 +
 
 +
<tr>
 +
<td>summary</td>
 +
<td>-</td>
 +
<td>分享到微博的文本内容</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td rowspan='5'>stream</td>
 +
<td>url</td>
 +
<td>视频流地址</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>duration</td>
 +
<td>视频时长，单位秒</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>height</td>
 +
<td>视频高，单位像素</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>width</td>
 +
<td>视频宽，单位像素</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>format</td>
 +
<td>视频格式</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>custom_data</td>
 +
<td>source</td>
 +
<td>视频来源信息</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>object_type</td>
 +
<td>-</td>
 +
<td>对象类型</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td rowspan='4'> author </td>
 +
<td>object_type</td>
 +
<td>person</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>id</td>
 +
<td>微博用户uid</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>display_name</td>
 +
<td>微博昵称</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>url</td>
 +
<td>微博用户地址</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td>object_type_detail</td>
 +
<td>-</td>
 +
<td>视频子类型</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td rowspan='3'>image</td>
 +
<td>url</td>
 +
<td> 封面图地址</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td> height </td>
 +
<td> 封面图高，单位像素 </td>
 +
</tr>
 +
 
 +
<tr>
 +
<td> width </td>
 +
<td> 封面图宽，单位像素 </td>
 +
</tr>
 +
 
 +
<tr>
 +
<td> links </td>
 +
<td> - </td>
 +
<td> 视频短链跳转地址 </td>
 +
</tr>
 +
 
 +
<tr>
 +
<td> url </td>
 +
<td> - </td>
 +
<td> 视频落地页地址 </td>
 +
</tr>
 +
 
 +
<tr>
 +
<td> display_name </td>
 +
<td> - </td>
 +
<td> 缩略名称 </td>
 +
</tr>
 +
 
 +
<tr>
 +
<td> embed_code </td>
 +
<td> - </td>
 +
<td> 第三方嵌套flash播放地址</td>
 +
</tr>
 +
 
 +
<tr>
 +
<td> target_url </td>
 +
<td> - </td>
 +
<td> 视频落地页地址</td>
 +
</tr>
 +
 
 +
</table>
 +
</center>
 +
 
 
json格式视频对象信息示例：
 
json格式视频对象信息示例：
 +
 
<pre class="brush:js">
 
<pre class="brush:js">
 
  {
 
  {
−
summary: "深度：三星帝国走向崩溃？ via@时差视频",//分享到微博的文本内容
+
summary: "深度：三星帝国走向崩溃？ via@时差视频",//分享到微博的文本内容
−
stream: {//视频流信息
+
stream: {//视频流信息
 
duration: 124,//视频时长，单位秒
 
duration: 124,//视频时长，单位秒
 
height: 360,//视频高，单位像素
 
height: 360,//视频高，单位像素
第22行： 第160行：
 
format: "mp4",//视频格式
 
format: "mp4",//视频格式
 
url: "http://gslb.miaopai.com/stream/iBYaI~-~CFUJVZ7VuRtmqg__.mp4?yx=&refer=weibo_app"//视频流地址
 
url: "http://gslb.miaopai.com/stream/iBYaI~-~CFUJVZ7VuRtmqg__.mp4?yx=&refer=weibo_app"//视频流地址
−
},
+
},
−
custom_data: {
+
custom_data: {
−
source: "秒拍视频"
+
source: "秒拍视频"
−
},
+
},
−
object_type: "video",//对象类型，video表示视频
+
object_type: "video",//对象类型，video表示视频
−
author: {//视频作者信息
+
author: {//视频作者信息
−
object_type: "person",
+
object_type: "person",
−
id: "6002842109",//微博uid
+
id: "6002842109",//微博uid
−
display_name: “时差视频"//微博昵称
+
display_name: “时差视频"//微博昵称
−
url: “http://weibo.com/u/6002842109”//微博用户地址
+
url: “http://weibo.com/u/6002842109”//微博用户地址
−
},
+
},
−
object_type_detail: “minivideo",//视频子类型，例如miguvideo
+
object_type_detail: “minivideo",//视频子类型，例如miguvideo
−
image: {//视频封面图信息
+
image: {//视频封面图信息
−
height: 360,//封面图高，单位像素
+
height: 360,//封面图高，单位像素
−
width: 640,//封面图宽，单位像素
+
width: 640,//封面图宽，单位像素
−
url: "http://wscdn.miaopai.com/stream/iBYaI~-~CFUJVZ7VuRtmqg___tmp_11_356_.jpg"//封面图地址
+
url: "http://wscdn.miaopai.com/stream/iBYaI~-~CFUJVZ7VuRtmqg___tmp_11_356_.jpg"//封面图地址
−
},
+
},
−
links: {
+
links: {
−
url: "http://mobile.yixia.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm"
+
url: "http://mobile.yixia.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm"
−
},
+
},
−
url: "http://miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm",//视频落地页地址
+
url: "http://miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm",//视频落地页地址
−
display_name: “咪咕视频",//缩略名称
+
display_name: “秒拍视频",//短链上显示的名称
−
embed_code: "http://www.miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.swf",//第三方嵌套flash播放地址
+
embed_code: "http://www.miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.swf",//第三方嵌套flash播放地址
−
target_url:"http://miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm",//视频落地页地址
+
target_url:"http://miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm",//视频落地页地址
 
}
 
}
 
</pre>
 
</pre>
 +
 
==第三方主动更新对象信息接口==
 
==第三方主动更新对象信息接口==
 
参见平台文档：http://open.weibo.com/wiki/2/short_url/info/force_update
 
参见平台文档：http://open.weibo.com/wiki/2/short_url/info/force_update

2016年10月13日 (四) 11:56的最后版本

目录

视频服务第三方接入

概述

微博平台支持第三方视频网站地址分享到微博后，以视频形式展示给用户。当分享到微博后，微博平台会识别第三方URL域名，通过回调其提供的接口，获取该URL的信息并做保存，最后带有该URL的微博会以视频形式展现给用户。

开发者接入步骤

（2.1）申请成为微博平台开发者。详见新手指南

（2.2）提供第三方URL域名。

（2.3）提供视频信息回调接口。 详见下文

（2.4）视频信息若有变动，需主动调用微博接口更新该视频信息。 详见下文

（2.5）开发联调，测试上线。

第三方视频信息回调接口

URL : http://***.com/***?url=***

说明：由第三方提供该回调接口，返回完整的JSON格式的视频对象信息，参数url为透传第三方分享到微博的链接地址url

视频对象信息说明：

对象一级字段 二级字段 字段说明
summary - 分享到微博的文本内容
stream url 视频流地址
duration 视频时长，单位秒
height 视频高，单位像素
width 视频宽，单位像素
format 视频格式
custom_data source 视频来源信息
object_type - 对象类型
author object_type person
id 微博用户uid
display_name 微博昵称
url 微博用户地址
object_type_detail - 视频子类型
image url 封面图地址
height 封面图高，单位像素
width 封面图宽，单位像素
links - 视频短链跳转地址
url - 视频落地页地址
display_name - 缩略名称
embed_code - 第三方嵌套flash播放地址
target_url - 视频落地页地址

json格式视频对象信息示例： 

 {
	summary: "深度：三星帝国走向崩溃？ via@时差视频",//分享到微博的文本内容
	stream: {//视频流信息
			duration: 124,//视频时长，单位秒
			height: 360,//视频高，单位像素
			width: 640,//视频宽，单位像素
			format: "mp4",//视频格式
			url: "http://gslb.miaopai.com/stream/iBYaI~-~CFUJVZ7VuRtmqg__.mp4?yx=&refer=weibo_app"//视频流地址
	},
	custom_data: {
		source: "秒拍视频"
	},
	object_type: "video",//对象类型，video表示视频
	author: {//视频作者信息
		object_type: "person",
		id: "6002842109",//微博uid
		display_name: “时差视频"//微博昵称
		url: “http://weibo.com/u/6002842109”//微博用户地址
	},
	object_type_detail: “minivideo",//视频子类型，例如miguvideo
	image: {//视频封面图信息
		height: 360,//封面图高，单位像素
		width: 640,//封面图宽，单位像素
		url: "http://wscdn.miaopai.com/stream/iBYaI~-~CFUJVZ7VuRtmqg___tmp_11_356_.jpg"//封面图地址
	},
	links: {
		url: "http://mobile.yixia.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm"
	},		
	url: "http://miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm",//视频落地页地址
	display_name: “秒拍视频",//短链上显示的名称
	embed_code: "http://www.miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.swf",//第三方嵌套flash播放地址
	target_url:"http://miaopai.com/show/iBYaI~-~CFUJVZ7VuRtmqg__.htm",//视频落地页地址
}

第三方主动更新对象信息接口

参见平台文档：http://open.weibo.com/wiki/2/short_url/info/force_update

来自“http://open.weibo.com/wiki/index.php?title=Video/thirdapi&oldid=15147”
文档更新时间: 2016-10-13

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA