Video/thirdapi

跳转到: 导航, 搜索
(第三方视频信息回调接口)
 
(未显示1个用户的4个中间版本)
第15行: 第15行:
 
==第三方视频信息回调接口==
 
==第三方视频信息回调接口==
 
URL : http://***.com/***?url=***
 
URL : http://***.com/***?url=***
 +
 
说明:由第三方提供该回调接口,返回完整的JSON格式的视频对象信息,参数url为透传第三方分享到微博的链接地址url
 
说明:由第三方提供该回调接口,返回完整的JSON格式的视频对象信息,参数url为透传第三方分享到微博的链接地址url
 +
 
<b>视频对象信息说明:</b>
 
<b>视频对象信息说明:</b>
 
<center>
 
<center>
第30行: 第32行:
 
<td>summary</td>
 
<td>summary</td>
 
<td>-</td>
 
<td>-</td>
<td> 分享到微博的文本内容 </td>
+
<td>分享到微博的文本内容</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td>stream</td>
+
<td rowspan='5'>stream</td>
<td>-</td>
+
<td> 视频流信息 </td>
+
</tr>
+
 
+
<tr>
+
<td>summary</td>
+
<td>-</td>
+
<td> 分享到微博的文本内容 </td>
+
</tr>
+
 
+
<tr>
+
<td></td>
+
 
<td>url</td>
 
<td>url</td>
<td> 视频流地址 </td>
+
<td>视频流地址</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
 
 
<td>duration</td>
 
<td>duration</td>
<td>视频时长,单位秒 </td>
+
<td>视频时长,单位秒</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
+
<td>height</td>
<td> height </td>
+
<td>视频高,单位像素</td>
<td> 视频高,单位像素 </td>
+
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
 
 
<td>width</td>
 
<td>width</td>
<td> 视频宽,单位像素 </td>
+
<td>视频宽,单位像素</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
+
<td>format</td>
<td> format </td>
+
<td>视频格式</td>
<td> 视频格式 </td>
+
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td> custom_data </td>
+
<td>custom_data</td>
<td> - </td>
+
<td>source</td>
<td> 视频来源 </td>
+
<td>视频来源信息</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
+
<td>object_type</td>
<td> source </td>
+
<td>-</td>
<td> 视频来源信息 </td>
+
<td>对象类型</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td> object_type </td>
+
<td rowspan='4'> author </td>
<td> - </td>
+
<td>object_type</td>
<td> 对象类型</td>
+
<td>person</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td> author </td>
+
<td>id</td>
<td> - </td>
+
<td>微博用户uid</td>
<td> 视频作者信息 </td>
+
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
+
<td>display_name</td>
<td> object_type </td>
+
<td>微博昵称</td>
<td> person </td>
+
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
+
<td>url</td>
<td> id </td>
+
<td>微博用户地址</td>
<td> 微博用户uid </td>
+
</tr>
+
 
+
<tr>
+
<td></td>
+
<td> display_name </td>
+
<td> 微博昵称 </td>
+
</tr>
+
 
+
<tr>
+
<td></td>
+
<td> url </td>
+
<td> 微博用户地址</td>
+
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
 
<td>object_type_detail</td>
 
<td>object_type_detail</td>
<td> - </td>
+
<td>-</td>
<td> 视频子类型 </td>
+
<td>视频子类型</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td>image</td>
+
<td rowspan='3'>image</td>
<td> - </td>
+
<td>url</td>
<td> 视频封面图 </td>
+
<td> 封面图地址</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<td></td>
 
 
<td> height </td>
 
<td> height </td>
 
<td> 封面图高,单位像素 </td>
 
<td> 封面图高,单位像素 </td>
第142行: 第112行:
  
 
<tr>
 
<tr>
<td></td>
 
 
<td> width </td>
 
<td> width </td>
 
<td> 封面图宽,单位像素 </td>
 
<td> 封面图宽,单位像素 </td>
第148行: 第117行:
  
 
<tr>
 
<tr>
<td>links</td>
+
<td> links </td>
 
<td> - </td>
 
<td> - </td>
 
<td> 视频短链跳转地址 </td>
 
<td> 视频短链跳转地址 </td>
第157行: 第126行:
 
<td> - </td>
 
<td> - </td>
 
<td> 视频落地页地址 </td>
 
<td> 视频落地页地址 </td>
</tr>
 
 
<tr>
 
<td></td>
 
<td> url </td>
 
<td> 封面图地址</td>
 
 
</tr>
 
</tr>
  
第185行: 第148行:
 
</table>
 
</table>
 
</center>
 
</center>
 
  
 
json格式视频对象信息示例:
 
json格式视频对象信息示例:
第219行: 第181行:
 
},
 
},
 
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",//视频落地页地址

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

文档更新时间: 2016-10-13