微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
=直播服务第三方接入= ==第三方直播源接入流程== 适用有自己的直播CDN服务的第三方接入: 第一步:第三方申请微博开发者,获取平台分配的应用appkey [http://open.weibo.com/wiki/%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97 详见新手指南] 第二步:第三方提供分享到微博的直播播放落地页url 第三步:第三方提供回调接口,平台提供domainid,详见下文 第四步:平台配置分享url第三方回调,解析直播播放card 触发机制:新的url分享到微博默认回调,平台永久缓存对应的直播对象信息,之后除非触发某种更新机制,会再次回调 第五步:平台申请直播业务bizid,配置客户端和PC端的直播card解析 第六步:第三方主动更新直播信息,平台分配加密秘钥 ==第三方提供回调接口== URL : http://***.com/***?url=*** 说明:由第三方提供该回调接口,返回完整的JSON格式的直播对象信息,参数url为透传第三方分享到微博的链接地址url <b>参数说明:</b> <center><table class="wiki_table" border="0" cellspacing="0" cellpadding="0"> <tr> <th class="wiki_table_thfirst" scope="col" width="25%">直播对象一级字段</th> <th scope="col" width="20%">二级字段</th> <th scope="col" width="55%">字段说明</th> </tr> <tr> <td>summary</td> <td>-</td> <td>微博文本内容,分享到微博的文本内容</td> </tr> <tr> <td rowspan='3'>stream</td> <td>hd_url</td> <td>直播高清地址</td> </tr> <tr> <td>format</td> <td>直播地址格式</td> </tr> <tr> <td>ld_url</td> <td>直播标清地址</td> </tr> <tr> <td rowspan='8'>urls</td> <td>live_flv_hd</td> <td>直播高清地址-flv格式,如没有默认空</td> </tr> <tr> <td>live_flv_ld</td> <td>直播标清地址-flv格式,如没有默认空</td> </tr> <tr> <td>rtmp_hd</td> <td>直播高清地址-rtmp格式,如没有默认空</td> </tr> <tr> <td>rtmp_ld</td> <td>直播标清地址-rtmp格式,如没有默认空</td> </tr> <tr> <td>live_hd</td> <td>直播高清地址-hls格式,如没有默认空</td> </tr> <tr> <td>live_ld</td> <td>直播标清地址-hls格式,如没有默认空,以上格式必须提供一种,如果没有分高标清,赋值成相同的地址</td> </tr> <tr> <td>replay_hd</td> <td>直播回放高清地址</td> </tr> <tr> <td>replay_ld</td> <td>直播回放标清地址</td> </tr> <tr> <td rowspan='3'>image</td> <td>width</td> <td>封面图宽</td> </tr> <tr> <td>height</td> <td>封面图高</td> </tr> <tr> <td>url</td> <td>直播封面图地址</td> </tr> <tr> <td rowspan='3'>author</td> <td>id</td> <td>直播主播对应的微博用户id(uid),如果第三方没有对应的微博UID,第三方回调接口请直接返回错误提示</td> </tr> <tr> <td>object_type</td> <td>直播主播类型,默认person</td> </tr> <tr> <td>display_name</td> <td>直播主播微博昵称</td> </tr> <tr> <td rowspan='3'>live</td> <td>width</td> <td>直播流宽,直播流原始分辨率,根据这个宽高比信息自适应直播播放器显示横屏竖屏</td> </tr> <tr> <td>height</td> <td>直播流高</td> </tr> <tr> <td>bitrate</td> <td>直播流码率</td> </tr> <tr> <td>id</td> <td>-</td> <td>直播对象ID,一般默认规则(domainid:md5(url)),冒号之前为微博平台分配的域名ID,冒号之后保证唯一值</td> </tr> <tr> <td>object_type</td> <td>-</td> <td>直播对象类型,默认 live</td> </tr> <tr> <td>object_type_detail</td> <td>-</td> <td>直播对象详情,默认微博直播“weibolive”</td> </tr> <tr> <td>mid</td> <td>-</td> <td>直播主播分享的原创微博mid,目前第三方接入微博sdk的方式分享到微博无法获取到mid,只有通过服务层调用平台分享微博接口才能获取到mid,如没有默认空,影响互动打通等直播功能</td> </tr> <tr> <td>display_name</td> <td>-</td> <td>直播短链标题,默认“微博直播”</td> </tr> <tr> <td>title</td> <td>-</td> <td>直播标题</td> </tr> <tr> <td>status</td> <td>-</td> <td>直播实时状态(0 未开始,1 直播中,2 直播删除, 3 直播结束)</td> </tr> <tr> <td>stime</td> <td>-</td> <td>直播开始时间</td> </tr> <tr> <td>etime</td> <td>-</td> <td>直播结束时间</td> </tr> <tr> <td>updated_at</td> <td>-</td> <td>直播创建时间</td> </tr> <tr> <td>duration</td> <td>-</td> <td>直播持续时长</td> </tr> <tr> <td>url</td> <td>-</td> <td>直播落地页地址</td> </tr> <tr> <td>target_url</td> <td>-</td> <td>直播落地页地址</td> </tr> <tr> <td>share_text</td> <td>-</td> <td>直播分享文案</td> </tr> <tr> <td>embed_code</td> <td>-</td> <td>直播flash播放地址</td> </tr> <tr> <td>scheme_app_ios</td> <td>-</td> <td>呼起第三方直播ios app地址,默认空</td> </tr> <tr> <td>scheme_app_android</td> <td>-</td> <td>呼起第三方直播android app地址,默认空</td> </tr> <tr> <td>app_ios_url</td> <td>-</td> <td>呼起第三方直播ios app下载地址,默认空</td> </tr> <tr> <td>app_android_url</td> <td>-</td> <td>呼起第三方直播android app下载地址,默认空</td> </tr> </table> </center> 示例: <pre> { summary: "【暴雨袭击江西南昌 央视记者正在直播】江西省南昌市昨晚迎来强降雨,27个站点降雨量超过100毫米,气象部门不断升级暴雨预警。今天,南昌市区多个路段出现积水,记者所在的立交桥积水深度超过1.5米,有车辆陷入积水中。央视新闻记者正在现场直播。(央视记者王舒畅)", stream: { hd_url: "http://***", format: "m3u8", url: "http://***" }, app_android_url: "", stime: "2016-06-02 11:24:46", id: "1042097:5d9361da897dfe7c7d1f343b74bee53d", object_type: "live", author: { id: "2656274875", object_type: "person", display_name: "央视新闻" }, title: "暴雨袭击南昌 央视记者正在直播", scheme_app_android: "", app_ios_url: "", scheme_app_ios: "", disable_replay: 0, share_text: "@央视新闻 正在直播中,场面异常火爆,小伙伴们速来围观... http://live.weibo.com/show?id=1042097:5d9361da897dfe7c7d1f343b74bee53d", live: { height: "450", width: "800", bitrate: "500" }, status: 3, urls: { live_ld: "http://***", replay_ld: "http://***", rtmp_ld: "rtmp://***", live_flv_ld: "http://***.flv", live_hd: "http://***", replay_hd: "http://***", rtmp_hd: "rtmp://***", live_flv_hd: "http://***.flv", }, object_type_detail: "weibolive", //第三方接入命名协商 image: { height: "450", width: "800", url: "http://ww3.sinaimg.cn/large/941f7a2fjw1f4gptlnkh0j20fk08rgo7.jpg" }, url: "http://live.weibo.com/show?id=1042097:5d9361da897dfe7c7d1f343b74bee53d", background_url: "", display_name: "微博直播", //微博短链上的文案显示 duration: 1218.599, updated_at: "2016-06-02", etime: "2016-06-02 12:01:01", embed_code: "http://****/v.swf", //第三方直播播放器 mid: "3981885077804051", target_url: "http://live.weibo.com/show?id=1042097:5d9361da897dfe7c7d1f343b74bee53d", } </pre> ==更新直播信息接口== URL : http://live.weibo.com/proxy/updatestatus [POST] 说明:第三方直播对象的任何信息发生变更,需要调用该接口同步微博,比如直播状态变更、播放地址更新、回放地址生成、封面图更新等等 参数: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{api_args|source|true|string|直播来源,即appkey}} {{api_args|uid|true|string|直播主播的微博uid}} {{api_args|liveid|true|string|直播ID,即直播对象中的id}} {{api_args|status|true|string|直播状态,0:未直播 1:直播中 2:删除或举报 3:直播结束 4:直播延迟}} {{api_args|url|true|string|第三方直播落地页,即直播对象中的url}} {{api_args|sign|true|string|签名校验,具体的加密算法见下文}} {{api_args|useragent|false|string|用户ua信息}} |} 返回: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选 !width="75%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{rdes_args|code|string|错误代码,0 请求正常,其他错误详见下文的错误代码说明}} {{rdes_args|msg|string|错误信息}} {{rdes_args|data|string|如果请求正常,返回直播对象信息}} |} 示例: <pre> { } </pre> ==接口签名校验== 每个接入的第三方会分配一个秘钥,根据微博提供的加密算法进行接口校验,加密算法微博平台单独文档提供 ==错误代码== 错误码 {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|错误码 !width="40%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|错误msg !width="45%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|描述 {{rdes_args|10000|sign error|sign值错误}} {{rdes_args|10001|id error|直播id不存在}} {{rdes_args|10002|param loss|字段为空}} {{rdes_args|10003|param error|字段错误}} |}
该页面使用的模板:
模板:Api args
(
查看源代码
)
模板:Rdes args
(
查看源代码
)
返回到
Live/thirdapi
。
反馈
分享
顶部