Video/thirdapi
(→第三方视频信息回调接口) |
(→第三方视频信息回调接口) |
||
第16行: | 第16行: | ||
URL : http://***.com/***?url=*** | URL : http://***.com/***?url=*** | ||
说明:由第三方提供该回调接口,返回完整的JSON格式的视频对象信息,参数url为透传第三方分享到微博的链接地址url | 说明:由第三方提供该回调接口,返回完整的JSON格式的视频对象信息,参数url为透传第三方分享到微博的链接地址url | ||
+ | |||
<b>视频对象信息说明:</b> | <b>视频对象信息说明:</b> | ||
<center> | <center> | ||
第28行: | 第29行: | ||
<tr> | <tr> | ||
− | <td | + | <td>summary</td> |
<td>-</td> | <td>-</td> | ||
− | <td> 分享到微博的文本内容 </td> | + | <td>分享到微博的文本内容</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td rowspan='3'> stream </td> | + | <td rowspan='3'>stream</td> |
<td>-</td> | <td>-</td> | ||
− | <td> 视频流信息 </td> | + | <td>视频流信息</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | |||
<td>url</td> | <td>url</td> | ||
− | <td> 视频流地址 </td> | + | <td>视频流地址</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | |||
<td>duration</td> | <td>duration</td> | ||
− | <td>视频时长,单位秒 </td> | + | <td>视频时长,单位秒</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>height</td> | |
− | <td> height </td> | + | <td>视频高,单位像素</td> |
− | <td> 视频高,单位像素 </td> | + | |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | |||
<td>width</td> | <td>width</td> | ||
− | <td> 视频宽,单位像素 </td> | + | <td>视频宽,单位像素</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>format</td> | |
− | <td> format </td> | + | <td>视频格式</td> |
− | <td> 视频格式 </td> | + | |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td rowspan='3'> custom_data </td> | + | <td rowspan='3'>custom_data</td> |
− | <td> - </td> | + | <td>-</td> |
− | <td> 视频来源 </td> | + | <td>视频来源</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>source</td> | |
− | <td> source </td> | + | <td>视频来源信息</td> |
− | <td> 视频来源信息 </td> | + | |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td rowspan='3'> object_type </td> | + | <td rowspan='3'>object_type</td> |
− | <td> - </td> | + | <td>-</td> |
− | <td> 对象类型</td> | + | <td>对象类型</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
<td rowspan='3'> author </td> | <td rowspan='3'> author </td> | ||
− | <td> - </td> | + | <td>-</td> |
− | <td> 视频作者信息 </td> | + | <td>视频作者信息</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>object_type</td> | |
− | <td> object_type </td> | + | <td>person</td> |
− | <td> person </td> | + | |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>id</td> | |
− | <td> id </td> | + | <td>微博用户uid</td> |
− | <td> 微博用户uid </td> | + | |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>display_name</td> | |
− | <td> display_name </td> | + | <td>微博昵称</td> |
− | <td> 微博昵称 </td> | + | |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>url</td> | |
− | <td> url </td> | + | <td>微博用户地址</td> |
− | <td> 微博用户地址</td> | + | |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td rowspan='3'> object_type_detail </td> | + | <td rowspan='3'>object_type_detail</td> |
− | <td> - </td> | + | <td>-</td> |
− | <td> 视频子类型 </td> | + | <td>视频子类型</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td rowspan='3'> image </td> | + | <td rowspan='3'>image</td> |
− | <td> - </td> | + | <td>-</td> |
− | <td> 视频封面图 </td> | + | <td>视频封面图</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td>url</td> | |
− | <td> url </td> | + | |
<td> 封面图地址</td> | <td> 封面图地址</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
− | |||
<td> height </td> | <td> height </td> | ||
<td> 封面图高,单位像素 </td> | <td> 封面图高,单位像素 </td> | ||
第142行: | 第131行: | ||
<tr> | <tr> | ||
− | |||
<td> width </td> | <td> width </td> | ||
<td> 封面图宽,单位像素 </td> | <td> 封面图宽,单位像素 </td> |
2016年10月11日 (二) 17:30的版本
目录 |
视频服务第三方接入
概述
微博平台支持第三方视频网站地址分享到微博后,以视频形式展示给用户。当分享到微博后,微博平台会识别第三方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