Video/thirdapi
(→第三方视频信息回调接口) |
|||
(未显示1个用户的3个中间版本) | |||
第15行: | 第15行: | ||
==第三方视频信息回调接口== | ==第三方视频信息回调接口== | ||
URL : http://***.com/***?url=*** | URL : http://***.com/***?url=*** | ||
+ | |||
说明:由第三方提供该回调接口,返回完整的JSON格式的视频对象信息,参数url为透传第三方分享到微博的链接地址url | 说明:由第三方提供该回调接口,返回完整的JSON格式的视频对象信息,参数url为透传第三方分享到微博的链接地址url | ||
+ | |||
<b>视频对象信息说明:</b> | <b>视频对象信息说明:</b> | ||
<center> | <center> | ||
第28行: | 第30行: | ||
<tr> | <tr> | ||
− | <td | + | <td>summary</td> |
<td>-</td> | <td>-</td> | ||
− | <td> 分享到微博的文本内容 </td> | + | <td>分享到微博的文本内容</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td rowspan=' | + | <td rowspan='5'>stream</td> |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
<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 | + | <td>custom_data</td> |
− | <td> | + | <td>source</td> |
− | <td> | + | <td>视频来源信息</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td></td> | + | <td>object_type</td> |
− | <td> | + | <td>-</td> |
− | <td> | + | <td>对象类型</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td rowspan=' | + | <td rowspan='4'> author </td> |
− | <td> | + | <td>object_type</td> |
− | <td> | + | <td>person</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td | + | <td>id</td> |
− | <td> | + | <td>微博用户uid</td> |
− | + | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td></td> | + | <td>display_name</td> |
− | <td> | + | <td>微博昵称</td> |
− | + | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td></td> | + | <td>url</td> |
− | <td> | + | <td>微博用户地址</td> |
− | + | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td></td> | + | <td>object_type_detail</td> |
− | <td> | + | <td>-</td> |
− | <td> | + | <td>视频子类型</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | + | <td rowspan='3'>image</td> | |
− | + | <td>url</td> | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | <td rowspan='3'> image | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | <td> url </td> | + | |
<td> 封面图地址</td> | <td> 封面图地址</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
− | |||
<td> height </td> | <td> height </td> | ||
<td> 封面图高,单位像素 </td> | <td> 封面图高,单位像素 </td> | ||
第142行: | 第112行: | ||
<tr> | <tr> | ||
− | |||
<td> width </td> | <td> width </td> | ||
<td> 封面图宽,单位像素 </td> | <td> 封面图宽,单位像素 </td> | ||
第148行: | 第117行: | ||
<tr> | <tr> | ||
− | <td | + | <td> links </td> |
<td> - </td> | <td> - </td> | ||
<td> 视频短链跳转地址 </td> | <td> 视频短链跳转地址 </td> | ||
第154行: | 第123行: | ||
<tr> | <tr> | ||
− | <td | + | <td> url </td> |
<td> - </td> | <td> - </td> | ||
<td> 视频落地页地址 </td> | <td> 视频落地页地址 </td> | ||
第160行: | 第129行: | ||
<tr> | <tr> | ||
− | <td | + | <td> display_name </td> |
<td> - </td> | <td> - </td> | ||
<td> 缩略名称 </td> | <td> 缩略名称 </td> | ||
第166行: | 第135行: | ||
<tr> | <tr> | ||
− | <td | + | <td> embed_code </td> |
<td> - </td> | <td> - </td> | ||
<td> 第三方嵌套flash播放地址</td> | <td> 第三方嵌套flash播放地址</td> | ||
第172行: | 第141行: | ||
<tr> | <tr> | ||
− | <td | + | <td> target_url </td> |
<td> - </td> | <td> - </td> | ||
<td> 视频落地页地址</td> | <td> 视频落地页地址</td> | ||
第179行: | 第148行: | ||
</table> | </table> | ||
</center> | </center> | ||
− | |||
json格式视频对象信息示例: | json格式视频对象信息示例: | ||
第213行: | 第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