視頻直播開(kāi)放接口
直播服務(wù)OPEN API
閱讀以下文檔,幫助了解如何使用微博直播接口。
授權(quán)機(jī)制
目前微博開(kāi)放平臺(tái)用戶(hù)身份鑒權(quán)采用的是Oauth2.0,參見(jiàn) 如何登錄授權(quán)
訪問(wèn)頻次限制
訪問(wèn)級(jí)別:普通接口
頻次限制:是
關(guān)于頻次限制,參考接口訪問(wèn)權(quán)限說(shuō)明
創(chuàng)建直播
URL : https://api.weibo.com/2/proxy/live/create [POST]
說(shuō)明:新建直播對(duì)象,獲取直播推流地址,并同時(shí)發(fā)微博
參數(shù):
返回:
示例:
1 2 3 4 5 | { "id" : "230916c5fc9c48670bf72b9135261865ef35cd" , "room_id" : "1042097:5617ce1cc0f822ebd37f93a0275c8660" , "url" : "rtmp://ps.live.weibo.com/***/c5fc9c48670bf72b9135261865ef35cd?auth_key=***" } |
直播推流
第三方根據(jù)直播創(chuàng)建接口返回的推流地址rtmp_url開(kāi)始推流
更新直播
URL : https://api.weibo.com/2/proxy/live/update [POST]
說(shuō)明:直播對(duì)象信息、狀態(tài)等更新
參數(shù):
返回:
示例:
URL : https://api.weibo.com/2/proxy/live/delete [POST]
說(shuō)明:直播對(duì)象刪除,不可逆
參數(shù):
返回:
示例:
1 2 3 | { "id" : "230916c5fc9c48670bf72b9135261865ef35cd" } |
獲取直播信息
URL : https://api.weibo.com/2/proxy/live/show [POST]
說(shuō)明:直播對(duì)象信息、互動(dòng)信息等獲取
參數(shù):
返回:
示例:
1 2 3 4 5 6 7 8 9 | { "id" : "230912beaccf45a32ac3a36078b245ad8b5ddf" , "uid" : "2791445053" , "title" : "測(cè)試直播修改" , "summary" : "測(cè)試直播修改簡(jiǎn)介" , "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]
說(shuō)明:上傳圖片接口
是否需要登錄
true 登錄授權(quán)方式,請(qǐng)參見(jiàn)本W(wǎng)IKI內(nèi)的 如何登錄授權(quán)
請(qǐng)求參數(shù)
返回結(jié)果
//成功返回
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." } |
直播互動(dòng)接口
請(qǐng)參考直播互動(dòng)接口文檔
錯(cuò)誤代碼
錯(cuò)誤碼
示例:
1 2 3 4 5 | { request : error_code : error : } |