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

新浪SEA开放平台开发文档

更新时间2022-04-11

直播服务OPEN API

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

授权机制

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

访问频次限制

访问级别：普通接口

频次限制：是

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

创建直播

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

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

参数：

QQ截图20170209170259.png

QQ截图20170209170312.png

示例：

{

    "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

示例：

{

    "id": "230916c5fc9c48670bf72b9135261865ef35cd"
}

获取直播信息

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

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

参数：

QQ截图20170209170457.png

QQ截图20170209170510.png

示例：

{

    "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内的如何登录授权

请求参数

返回结果

//成功返回

{

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

//失败返回

{

    "request": "/2/statuses/upload_pic.json",

    "error_code": "201XX",

    "error": "error message."
}

直播互动接口

请参考直播互动接口文档

错误代码

错误码

QQ截图20170209170543.png

示例：

{

  request :

  error_code :

  error :
}