微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
=直播服务OPEN API= <div class="wiki_txtJ"> 阅读以下文档,帮助了解如何使用微博直播接口。 </div> ==授权机制== 目前微博开放平台用户身份鉴权采用的是Oauth2.0,参见 [http://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E 如何登录授权] ==访问频次限制== 访问级别:<span style="color:#FF7D13;">普通接口</span> 频次限制:<span style="color:#FF7D13;">是</span> 关于频次限制,参考[http://open.weibo.com/wiki/Rate-limiting 接口访问权限说明] ==创建直播== URL : https://api.weibo.com/2/proxy/live/create [POST] 说明:新建直播对象,获取直播推流地址,并同时发微博 参数: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{api_args|access_token|true|string|采用OAuth授权方式为必填参数,OAuth授权后获得}} {{api_args|title|true|string|直播描述}} {{api_args|width|true|string|直播宽度}} {{api_args|height|true|string|直播高度}} {{api_args|summary|false|string|微博文本内容,必须做URLencode,内容不超过130个汉字}} {{api_args|published|false|string|微博是否发布,0:公开发布,1:仅自己可见,默认为0}} {{api_args|image|false|string|封面图地址,注意封面图的宽高和直播的宽高比例要一致。需要上传图片参见本文档上传图片接口}} {{api_args|replay|false|string|是否录制,0:不录制,1:录制,默认为1}} |} 返回: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="75%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{rdes_args|id|string|直播ID}} {{rdes_args|rtmp_url|string|直播推流地址}} {{rdes_args|room_id|string|房间id}} |} 示例: <pre class="brush:js"> { "id": "230916c5fc9c48670bf72b9135261865ef35cd", "room_id": "1042097:5617ce1cc0f822ebd37f93a0275c8660", "url": "rtmp://ps.live.weibo.com/***/c5fc9c48670bf72b9135261865ef35cd?auth_key=***" } </pre> ==直播推流== 第三方根据直播创建接口返回的推流地址rtmp_url开始推流 ==更新直播== URL : https://api.weibo.com/2/proxy/live/update [POST] 说明:直播对象信息、状态等更新 参数: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{api_args|access_token|true|string|采用OAuth授权方式为必填参数,OAuth授权后获得}} {{api_args|id|true|string|直播ID}} {{api_args|title|false|string|直播描述}} {{api_args|summary|false|string|微博文本内容,必须做URLencode,内容不超过130个汉字}} {{api_args|published|false|string|微博是否发布,0:公开发布,1:仅自己可见,2:不发布 默认为2}} {{api_args|image|false|string|直播封面图地址}} {{api_args|stop|false|string|直播结束,0:直播中,1:直播结束,默认为0}} {{api_args|replay_url|false|string|直播回放地址}} |} 返回: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="75%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{rdes_args|id|string|直播ID}} |} 示例: <pre class="brush:js"> { "id": "230916c5fc9c48670bf72b9135261865ef35cd" } </pre> ==删除直播== URL : https://api.weibo.com/2/proxy/live/delete [POST] 说明:直播对象删除,不可逆 参数: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{api_args|access_token|true|string|采用OAuth授权方式为必填参数,OAuth授权后获得}} {{api_args|id|true|string|直播ID}} |} 返回: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="75%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{rdes_args|id|string|直播ID}} |} 示例: <pre class="brush:js"> { "id": "230916c5fc9c48670bf72b9135261865ef35cd" } </pre> ==获取直播信息== URL : https://api.weibo.com/2/proxy/live/show [POST] 说明:直播对象信息、互动信息等获取 参数: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{api_args|access_token|true|string|采用OAuth授权方式为必填参数,OAuth授权后获得}} {{api_args|id|true|string|直播ID}} {{api_args|detail|false|string|直播详情,0:不返回,1:返回,默认为0}} |} 返回: {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="75%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{rdes_args|id|string|直播ID}} {{rdes_args|uid|string|直播作者ID}} {{rdes_args|title|string|直播标题}} {{rdes_args|summary|string|微博文本内容}} {{rdes_args|image|string|封面图地址}} {{rdes_args|url|string|直播落地页}} {{rdes_args|status|int|直播状态}} {{rdes_args|create_time|string|直播创建时间}} {{rdes_args|live_views|int|直播实时在线人数,detail为1时返回}} {{rdes_args|total_views|int|直播总在线人数,detail为1时返回}} {{rdes_args|total_stars|int|直播总点赞数,detail为1时返回}} |} 示例: <pre class="brush:js"> { id : 230916c5fc9c48670bf72b9135261865ef35cd uid : 3549297570 title : test url : http://live.weibo.com/show?id=1042097:c5fc9c48670bf72b9135261865ef35cd summary : test image : http://ww2.sinaimg.cn/large/8c447cdejw1f4a0uie0bmj20m80ciwg3.jpg status : 1 live_views : 10 total_views : 100 total_stars : 100 create_time : 2016-06-02 17:10:54 } </pre> == 上传图片 == URL:https://api.weibo.com/statuses/upload_pic.json[POST] 说明:上传图片接口 '''是否需要登录''' true 登录授权方式,请参见本WIKI内的 [http://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E 如何登录授权] '''请求参数''' {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数字段 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段必选 !width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 !width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 {{api_args| access_token |true|string|采用OAuth授权方式为必填参数,OAuth授权后获得}} {{api_args| pic |true| binary |要上传的图片二进制流,仅支持JPEG、GIF、PNG格式,图片大小小于5M。}} {{api_args|print_mark|false|int|是否带水印,0:不带,1:带。}} {{api_args|ori|false|int|是否支持原图,0:不支持,1:支持。}} |} '''返回结果''' //成功返回 <pre class="brush:js"> { "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" } </pre> //失败返回 <pre class="brush:js"> { "request": "/2/statuses/upload_pic.json", "error_code": "201XX", "error": "error message." } </pre> ==直播互动接口== 请参考[http://open.weibo.com/wiki/Live/im/api 直播活动接口文档] ==错误代码== 错误码 {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color:#CCCCCC;" |- !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|错误码 !width="40%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|错误msg !width="45%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|描述 {{rdes_args|20001|live create error|创建直播失败}} {{rdes_args|20002|update weibo error|发微博失败}} {{rdes_args|20003|post param loss|post参数缺失}} {{rdes_args|20004|get param loss|get参数缺失}} {{rdes_args|20005|live delete error|删除直播失败}} {{rdes_args|20006|live update error|更新直播失败}} {{rdes_args|20007|send message error|评论失败}} {{rdes_args|20008|rsync message error|拉取失败}} {{rdes_args|20009|live id unexist|直播ID不存在}} {{rdes_args|20010|weibo content more than 130 word|微博文字超过130字了}} {{rdes_args|20011|msg content more than 100 word,or is null|评论文字超过100字了,或者为空}} {{rdes_args|20012|msg content type error|发言的文本类型错误}} {{rdes_args|20013|authority not allow|权限不够(appkey or uid不一致)}} {{rdes_args|20014|user not allow|uid不符合要求(用户满足:微博用户已绑定支付宝或黄V认证用户或媒体蓝v用户)}} |} 示例: <pre class="brush:js"> { request : error_code : error : } </pre> {{#a:nobtns|noheading}} __NOTOC__
该页面使用的模板:
模板:Api args
(
查看源代码
)
模板:Rdes args
(
查看源代码
)
返回到
Live/api
。
反馈
分享
顶部