Live/api

跳转到: 导航, 搜索

直播服务OPEN API


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


目录

授权机制

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

访问频次限制

访问级别:普通接口

频次限制:

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

创建直播

URL : 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 string 直播ID
rtmp_url string 直播推流地址
room_id string 房间id

示例:

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

直播推流

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


更新直播

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 string 直播ID

示例:

{
    "id": "230916c5fc9c48670bf72b9135261865ef35cd"
}

删除直播

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

说明:直播对象删除,不可逆

参数:

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

返回:

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

示例:

{
    "id": "230916c5fc9c48670bf72b9135261865ef35cd"
}

获取直播信息

URL : 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 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时返回

示例:

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

直播互动接口

请参考直播互动接口文档

错误代码

错误码

错误码 错误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认证用户开通直播功能,不在此范围内的用户需通过芝麻认证或人工认证才能进行直播)

示例:

{
  request :
  error_code :
  error :
}