2016年9月7日 (三) 20:21的最后版本

直播服务第三方接入

第三方直播源接入流程

这种接入方式适用于已有直播服务的开发者。 开发者将包含其直播间页面URL的博文，通过微博平台接口分享至微博，微博会识别开发者的URL域名，然后回调其提供的直播信息接口，获取该URL的直播信息，最后带有该直播URL的微博会以直播的形式展现给用户。

开发者接入步骤如下：

第一步：申请成为微博平台开发者。详见新手指南

第二步：提供直播页面的URL域名。

第三步：提供直播信息回调接口。 详见下文

第四步：直播信息若有变动(如直播开始和结束)，需要主动调用微博接口更新该直播信息。 详见下文

第五步：开发联调，测试上线。

第三方提供回调接口

URL : http://***.com/***?url=***

说明：由第三方提供该回调接口，返回完整的JSON格式的直播对象信息，参数url为透传第三方分享到微博的链接地址url

参数说明：

示例：

{
    "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]

说明：第三方直播对象的任何信息发生变更，需要调用该接口同步微博，比如直播状态变更、播放地址更新、回放地址生成、直播时长更新、封面图更新等等

参数：

返回：

示例：

{
    "code": 0, 
    "msg": "OK", 
    "data": [ ]
}

接口签名校验

每个接入的第三方会分配一个秘钥，根据微博提供的加密算法进行接口校验，加密算法微博平台单独文档提供

错误代码

错误码