微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
=直播服务OPEN API V1.0= ==直播接口授权机制== 目前微博开放平台用户身份鉴权采用的是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 如何登录授权] ==直播创建接口== 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|直播推流地址}} |} 示例: <pre> { id : 直播ID rtmp_url : 直播推流地址 } </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}} {{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> { id : } </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> { id : } </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> { id : uid : title : url : summary : image : status : live_views : total_views : create_time : } </pre> == 直播互动接口== ===直播上行互动=== URL : https://api.weibo.com/2/proxy/live/chatroom/r_msg [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|type|true|int|评论类型,现在只有文本,默认为0}} {{api_args|content|true|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> { id : context : } </pre> ===直播下行互动=== URL : https://api.weibo.com/2/proxy/live/chatroom/r_sync [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}} |} 返回示例: <pre> [ [MsgHeader,MsgBody], [NoticesHeader,NoticesBody], ...... ] </pre> <pre> MsgHeader = { type: "chatroom", proto: "r_msg", ...... } MsgBody = #r_msg: { "id": "uint64", //下行时为消息的global id "from": "uint64", //下行时为发送者的id "to": "string", //互动id "type": "uint32", "content": "string", "latitude": "string", "longitude": "string", "curr_play": "uint64", //记录直播直播进度,精确到毫秒;-1:未开始;0:直播已结束 "additional_desc": "string", "user":{ "id": "uint64", //uid "name": "string", //昵称 "avatar": "string" //头像信息 } } </pre> <pre> NoticesHeader = { type: "chatroom", proto: "r_notices", ...... } NoticesBody = #r_notices: { "id": "string", //房间对应的room id "error_msg": "string", //只有出错的时候才会提供此选项 "notices": [{ //多个通知列表 "type": "uint32", "users":[{ //同一种类型事件通知,可以为空,可以是单个用户,或多个用户等。 "id": "uint64", "name": "string", "avatar": "string" }], "value": "uint32", //其值类型由type确定,可以为空 "time": "uint64" }] } 注: type(通知类型): 4:点赞数量,users为空,value为点赞数量,uint32 </pre> ==错误代码== 错误码 {| 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不一致)}} |} 示例: <pre> { request : error_code : error : } </pre>
该页面使用的模板:
模板:Api args
(
查看源代码
)
模板:Rdes args
(
查看源代码
)
返回到
Live/api
。
反馈
分享
顶部