跳转到: 导航, 搜索

直播服务 OPEN API

阅读以下文档,帮助了解如何使用微博直播接口。


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

关于频次限制,参考接口访问权限说明


创建直播

https://api.weibo.com/2/proxy/live/create

POST

新建直播对象,获取直播推流地址,并同时发微博

参数

参数字段 字段必选 字段类型 字段说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得
title true string 直播描述
width true string 直播宽度
height true string 直播高度
summary false string 微博文本内容,必须做URLencode,内容不超过130个汉字
published false string 微博是否发布,0:公开发布,1:仅自己可见,默认为0
image false string 封面图地址,注意封面图的宽高和直播的宽高比例要一致。
replay false string 是否录制,0:不录制,1:录制,默认为1
is_panolive false string 是否全景直播,0:不是,1:是,默认为0

返回示例

{
    "id": "230916c5fc9c48670bf72b9135261865ef35cd",
    "room_id": "1042097:5617ce1cc0f822ebd37f93a0275c8660",
    "url": "rtmp://ps.live.weibo.com/***/c5fc9c48670bf72b9135261865ef35cd?auth_key=***"
}

返回字段说明

参数字段 字段类型 字段说明
id string 直播ID
rtmp_url string 直播推流地址
room_id string 房间id


直播推流

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


更新直播

https://api.weibo.com/2/proxy/live/update

POST

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

参数

参数字段 字段必选 字段类型 字段说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得
id true string 直播ID
title false string 直播描述
summary false string 微博文本内容,必须做URLencode,内容不超过130个汉字
published false string 微博是否发布,0:公开发布,1:仅自己可见,2:不发布 默认为2
image false string 直播封面图地址
stop false string 直播结束,0:直播中,1:直播结束,默认为0
replay_url false string 直播回放地址

返回示例

{
    "id": "230916c5fc9c48670bf72b9135261865ef35cd"
}

返回字段说明

参数字段 字段类型 字段说明
id string 直播ID


删除直播

https://api.weibo.com/2/proxy/live/delete

POST

直播对象删除,不可逆

参数

参数字段 字段必选 字段类型 字段说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得
id true string 直播ID

返回示例

{
    "id": "230916c5fc9c48670bf72b9135261865ef35cd"
}

返回字段说明

参数字段 字段类型 字段说明
id string 直播ID


获取直播信息

https://api.weibo.com/2/proxy/live/show

POST

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

参数

参数字段 字段必选 字段类型 字段说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得
id true string 直播ID
detail false string 直播详情,0:不返回,1:返回,默认为0

返回示例

{
    "id": "230912beaccf45a32ac3a36078b245ad8b5ddf",
    "uid": "2791445053",
    "title": "测试直播修改",
    "summary": "测试直播修改简介",
    "url": "http://live.weibo.com/show?id=1042097:beaccf45a32ac3a36078b245ad8b5ddf",
    "status": 3,
    "create_time": "2016-10-20 16:40:29"
}

返回字段说明

参数字段 字段类型 字段说明
id string 直播ID
uid string 直播作者ID
title string 直播标题
summary string 微博文本内容
image string 封面图地址
url string 直播落地页
status int 直播状态
create_time string 直播创建时间
live_views int 直播实时在线人数,detail为1时返回
total_views int 直播总在线人数,detail为1时返回
total_stars int 直播总点赞数,detail为1时返回


直播互动接口


错误代码

错误返回示例

{
  request :
  error_code :
  error :
}

错误码字段说明

错误码 错误msg 描述
20001 live create error 创建直播失败
20002 update weibo error 发微博失败
20003 post param loss post参数缺失
20004 get param loss get参数缺失
20005 live delete error 删除直播失败
20006 live update error 更新直播失败
20007 send message error 评论失败
20008 rsync message error 拉取失败
20009 live id unexist 直播ID不存在
20010 weibo content more than 130 word 微博文字超过130字了
20011 msg content more than 100 word,or is null 评论文字超过100字了,或者为空
20012 msg content type error 发言的文本类型错误
20013 authority not allow 权限不够(appkey or uid不一致)
20014 user not allow uid不符合要求(目前微博直播只支持橙V认证用户、媒体&政务蓝V认证用户开通直播功能,不在此范围内的用户需通过芝麻认证或人工认证才能进行直播)




文档更新时间: 2017-09-21