Video/thirdapi

跳转到: 导航, 搜索
第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
 
视频对象信息说明:
 
视频对象信息说明:
 +
 
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行: 第29行:
 
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月11日 (二) 15:17的版本

目录

视频服务第三方接入

概述

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

开发者接入步骤

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

(2.2)提供第三方URL域名。

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

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

(2.5)开发联调,测试上线。

第三方视频信息回调接口

URL : http://***.com/***?url=*** 说明:由第三方提供该回调接口,返回完整的JSON格式的视频对象信息,参数url为透传第三方分享到微博的链接地址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