Sina SEA open platform development documents
/ 视频直播开放接口
视频直播开放接口
直播服务OPEN API
阅读以下文档，帮助了解如何使用微博直播接口。
授权机制
目前微博开放平台用户身份鉴权采用的是Oauth2.0，参见 如何登录授权
访问频次限制
访问级别：普通接口
频次限制：是
关于频次限制，参考接口访问权限说明
创建直播
URL : https://api.weibo.com/2/proxy/live/create [POST]
说明：新建直播对象，获取直播推流地址，并同时发微博
参数：
返回：
示例：
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]
说明：直播对象信息、状态等更新
参数：
返回：
示例：
URL : https://api.weibo.com/2/proxy/live/delete [POST]
说明：直播对象删除，不可逆
参数：
返回：
示例：
1 2 3 | { "id": "230916c5fc9c48670bf72b9135261865ef35cd"} |
获取直播信息
URL : https://api.weibo.com/2/proxy/live/show [POST]
说明：直播对象信息、互动信息等获取
参数：
返回：
示例：
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内的 如何登录授权
请求参数
返回结果
//成功返回
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."} |
直播互动接口
请参考直播互动接口文档
错误代码
错误码
示例：
1 2 3 4 5 | { request : error_code : error :} |