新浪SEA开放平台开发文档 / 视频直播开放接口

视频直播开放接口

直播服务OPEN API


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

授权机制

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

访问频次限制

访问级别:普通接口

频次限制:

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

创建直播

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

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

参数:

QQ截图20170209170259.png

返回:

QQ截图20170209170312.png

示例:

1
2
3
4
5
{
    "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]

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

参数:

QQ截图20170209170337.png

返回:

QQ截图20170209170357.png

示例:

QQ截图20170209170410.png

删除直播

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

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

参数:

QQ截图20170209170428.png

返回:

QQ截图20170209170439.png

示例:

1
2
3
{
    "id": "230916c5fc9c48670bf72b9135261865ef35cd"
}

获取直播信息

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

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

参数:

QQ截图20170209170457.png

返回:

QQ截图20170209170510.png

示例:

1
2
3
4
5
6
7
8
9
{
    "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"
}

上传图片

URL:https://api.weibo.com/statuses/upload_pic.json[POST]

说明:上传图片接口


是否需要登录

true 登录授权方式,请参见本WIKI内的 如何登录授权


请求参数

QQ截图20170209170525.png

返回结果

//成功返回


1
2
3
4
5
6
7
{
    "pic_id": "946308c5jw1dv288whtylj",
    "thumbnail_pic": "http://ww3.sinaimg.cn/thumbnail/946308c5jw1dv288whtylj.jpg",
    "bmiddle_pic": "http://ww3.sinaimg.cn/bmiddle/946308c5jw1dv288whtylj.jpg",
    "original_pic": "http://ww3.sinaimg.cn/large/946308c5jw1dv288whtylj.jpg"
}


//失败返回


1
2
3
4
5
{
    "request": "/2/statuses/upload_pic.json",
    "error_code": "201XX",
    "error": "error message."
}

直播互动接口

请参考直播互动接口文档

错误代码

错误码

QQ截图20170209170543.png

示例:

1
2
3
4
5
{
  request :
  error_code :
  error :
}