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