Video/thirdapi

跳转到: 导航, 搜索

目录

视频服务第三方接入

概述

微博平台支持第三方视频网站地址分享到微博后,以视频形式展示给用户。当分享到微博后,微博平台会识别第三方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