视频直播开放接口
直播服务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 : } |