2016年6月2日 (四) 15:25的版本

直播服务OPEN API V1.0

直播接口授权机制

目前微博开放平台用户身份鉴权采用的是Oauth2.0，参见如何登录授权

直播创建接口

URL : https://api.weibo.com/2/proxy/live/create [POST]

说明：新建直播对象，获取直播推流地址，并同时发微博

参数：

返回：

示例：

{
	id : 直播ID
	rtmp_url : 直播推流地址
}

直播推流

第三方根据直播创建接口返回的推流地址rtmp_url开始推流

直播更新接口

URL : https://api.weibo.com/2/proxy/live/update [POST]

说明：直播对象信息、状态等更新

参数：

返回：

示例：

{
	id :
}

直播删除接口

URL : https://api.weibo.com/2/proxy/live/delete [POST]

说明：直播对象删除，不可逆

参数：

返回：

示例：

{
	id :
}

直播信息接口

URL : https://api.weibo.com/2/proxy/live/show [POST]

说明：直播对象信息、互动信息等获取

参数：

返回：

示例：

</pre> { id : uid : title : url : summary : image : status : live_views : total_views : create_time : } </pre>

直播互动接口

1. 1. 1. 上行互动

URL : https://api.weibo.com/2/proxy/live/chatroom/r_msg [POST]

说明：直播用户上行评论接口

参数：

返回：

示例：

{
    id :
    context : 
}

下行互动

URL : https://api.weibo.com/2/proxy/live/chatroom/r_sync [POST]

说明：直播者获取下行互动接口

参数：

返回示例：

[
    [MsgHeader,MsgBody],
    [NoticesHeader,NoticesBody],
    ......
]

MsgHeader = {
        type: "chatroom",
        proto: "r_msg",
        ......
    }
MsgBody = #r_msg: {
    "id": "uint64",     //下行时为消息的global id
    "from": "uint64",    //下行时为发送者的id
    "to": "string",     //互动id
    "type": "uint32",
    "content": "string",  
    "latitude": "string",
    "longitude": "string",
    "curr_play": "uint64",	     //记录直播直播进度，精确到毫秒；-1：未开始；0：直播已结束
    "additional_desc": "string", 
    "user":{
            "id": "uint64",	  //uid        
            "name": "string",   //昵称
            "avatar": "string"   //头像信息
    		}
}

NoticesHeader = {
        type: "chatroom",
        proto: "r_notices",
        ......
    }
NoticesBody = #r_notices: {
    "id": "string",           //房间对应的room id
    "error_msg": "string",    //只有出错的时候才会提供此选项
    "notices": [{             //多个通知列表 
        "type": "uint32",
        "users":[{            //同一种类型事件通知，可以为空，可以是单个用户，或多个用户等。
            "id": "uint64",
            "name": "string",
            "avatar": "string"
        }],
        "value": "uint32",    //其值类型由type确定，可以为空
        "time": "uint64"
    }]
}
注：
type(通知类型):
4：点赞数量，users为空，value为点赞数量，uint32

错误代码

错误码

示例：

{
	request :
	error_code :
	error :
}