Live/thirdapi
(以“=直播服务第三方接入= ==第三方直播源接入流程== ==第三方回调接口== URL : http://***.***.com/***?url=*** 说明：由第三方提供该回...”为内容创建页面) |
|||
| 第3行： | 第3行： | ||
==第三方回调接口== | ==第三方回调接口== | ||
| − | URL : http:// | + | URL : http://***.com/***?url=*** |
说明：由第三方提供该回调接口，返回完整的直播对象信息，JSON格式，参数url为第三方分享到微博的链接地址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> | ||
| + | |||
| + | </table> | ||
| + | </center> | ||
示例： | 示例： | ||
| 第40行： | 第116行： | ||
status: 3, | status: 3, | ||
urls: { | urls: { | ||
| − | |||
live_ld: "http://***", | live_ld: "http://***", | ||
replay_ld: "http://***", | replay_ld: "http://***", | ||
rtmp_ld: "rtmp://***", | rtmp_ld: "rtmp://***", | ||
live_flv_ld: "http://***.flv", | live_flv_ld: "http://***.flv", | ||
| − | |||
live_hd: "http://***", | live_hd: "http://***", | ||
| − | |||
replay_hd: "http://***", | replay_hd: "http://***", | ||
rtmp_hd: "rtmp://***", | rtmp_hd: "rtmp://***", | ||
live_flv_hd: "http://***.flv", | live_flv_hd: "http://***.flv", | ||
| − | |||
}, | }, | ||
object_type_detail: "weibolive", //第三方接入命名协商 | object_type_detail: "weibolive", //第三方接入命名协商 | ||
| 第114行： | 第186行： | ||
==接口签名校验== | ==接口签名校验== | ||
| − | + | 每个接入的第三方会分配一个秘钥，根据微博提供的加密算法进行接口校验，加密算法单独文档提供 | |
==错误代码== | ==错误代码== | ||
2016年6月3日 (五) 20:19的版本
目录 |
直播服务第三方接入
第三方直播源接入流程
第三方回调接口
URL : http://***.com/***?url=***
说明：由第三方提供该回调接口，返回完整的直播对象信息，JSON格式，参数url为第三方分享到微博的链接地址url
参数： 实物类：
| 直播对象一级字段 | 二级字段 | 备注 |
|---|---|---|
| summary | - | 微博文本内容 |
| stream | hd_url | 直播高清地址 |
| format | 直播地址格式 | |
| ld_url | 直播标清地址 | |
| urls | live_flv_hd | 直播高清地址-flv格式 |
| live_flv_ld | 直播标清地址-flv格式 | |
| rtmp_hd | 直播高清地址-rtmp格式 | |
| rtmp_ld | 直播标清地址-rtmp格式 | |
| live_hd | 直播高清地址-hls格式 | |
| live_ld | 直播标清地址-hls格式 | |
| replay_hd | 直播回放高清地址 | |
| replay_ld | 直播回放标清地址 |
示例：
{
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",
}
更新直播信息接口
URL : http://live.weibo.com/proxy/updatestatus [POST]
说明：第三方直播对象的任何信息发生变更，需要调用该接口同步微博，比如直播状态变更、播放地址更新、回放地址生成、封面图更新等等
参数：
| 参数字段 | 字段必选 | 字段类型 | 字段说明 |
|---|---|---|---|
| source | true | string | 直播来源，即appkey |
| uid | true | string | 直播主播的微博uid |
| liveid | true | string | 直播ID，即直播对象中的id |
| status | true | string | 直播状态，0：未直播 1：直播中 2：删除或举报 3：直播结束 4：直播延迟 |
| url | true | string | 第三方直播落地页，即直播对象中的url |
| sign | true | string | 签名校验，具体的加密算法见下文 |
| useragent | false | string | 用户ua信息 |
返回：
| 参数字段 | 字段必选 | 字段说明 |
|---|---|---|
| code | string | 错误代码，0 请求正常，其他错误详见下文的错误代码说明 |
| msg | string | 错误信息
{{rdes_args|data|string|如果请求正常，返回直播对象信息} |
示例：
{
}
接口签名校验
每个接入的第三方会分配一个秘钥，根据微博提供的加密算法进行接口校验，加密算法单独文档提供
错误代码
错误码
| 错误码 | 错误msg | 描述 |
|---|---|---|
| 10000 | sign error | sign值错误 |
| 10001 | id error | 直播id不存在 |
| 10002 | param loss | 字段为空 |
| 10003 | param error | 字段错误 |
