bilibili-API-collect/live/manage.md

直播间管理

• 更新直播间标题
• 开始直播
• 关闭直播

---

更新直播间标题

https://api.live.bilibili.com/room/v1/Room/update

请求方式：POST

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中bili_jct的值正确并与csrf相同

正文参数（ application/x-www-form-urlencoded ）：

参数名	类型	内容	必要性	备注
room_id	num	直播间id	必要	必须为自己的直播间id
title	str	直播间标题	必要	最大20字符
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 65530：token错误（登录错误） 1：错误
msg	str	错误信息	默认为ok
message	str	错误信息	默认为ok
data	array	空

示例：

修改直播间10352053标题为测试

curl 'https://api.live.bilibili.com/room/v1/Room/update' \
--data-urlencode 'room_id=10352053' \
--data-urlencode 'title=测试' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xx'

查看响应示例：

{
    "code": 0,
    "msg": "ok",
    "message": "ok",
    "data": []
}

开始直播

https://api.live.bilibili.com/room/v1/Room/startLive

请求方式：POST

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中bili_jct的值正确并与csrf相同

开播时必须有分区选择，开播后返回推流地址

正文参数（ application/x-www-form-urlencoded ）：

参数名	类型	内容	必要性	备注
room_id	num	直播间id	必要	必须为自己的直播间id
area_v2	num	直播分区id（子分区id）	必要	详见直播分区
platform	str	直播平台	必要	web端： bililink：android_link
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 65530：token错误（登录错误） 1：错误 60009：分区不存在 （其他错误码有待补充）
msg	str	错误信息	默认为空
message	str	错误信息	默认为空
data	obj	信息本体

data对象：

字段	类型	内容	备注
change	num	是否改变状态	0：未改变 1：改变
status	str	LIVE
room_type	num	0	作用尚不明确
rtmp	obj	RTMP推流地址信息
protocols	array	？？？	作用尚不明确
try_time	str	？？？	作用尚不明确
live_key	str	？？？	作用尚不明确
notice	obj	？？？	作用尚不明确

data中的rtmp对象：

字段	类型	内容	备注
addr	str	RTMP推流（发送）地址	重要
code	str	RTMP推流参数（密钥）	重要
new_link	str	获取CDN推流ip地址重定向信息的url	没啥用
provider	str	？？？	作用尚不明确

data中的protocols数组：

项	类型	内容	备注
0	obj	？？？	作用尚不明确

data中的protocols数组中的对象：

字段	类型	内容	备注
protocol	str	rtmp	作用尚不明确
addr	str	RTMP推流（发送）地址
code	str	RTMP推流参数（密钥）
new_link	str	获取CDN推流ip地址重定向信息的url
provider	str	txy	作用尚不明确

data中的notice对象：

字段	类型	内容	备注
type	num	1	作用尚不明确
status	num	0	作用尚不明确
title	str	空	作用尚不明确
msg	str	空	作用尚不明确
button_text	str	空	作用尚不明确
button_url	str	空	作用尚不明确

示例：

以27作为分区id开播直播间10352053

其中"data"."rtmp"."addr"为推流地址

"data"."rtmp"."code"为推流参数

curl 'https://api.live.bilibili.com/room/v1/Room/startLive' \
--data-urlencode 'room_id=10352053' \
--data-urlencode 'area_v2=27' \
--data-urlencode 'platform=pc' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xx'

查看响应示例：

{
    "code": 0,
    "msg": "",
    "message": "",
    "data": {
        "change": 1,
        "status": "LIVE",
        "room_type": 0,
        "rtmp": {
            "addr": "rtmp://txy.live-send.acg.tv/live-txy/",
            "code": "?streamname=live_293793435_1567354&key=***",
            "new_link": "http://tcdns.myqcloud.com:8086/bilibili_redirect?up_rtmp=txy.live-send.acg.tv%2Flive-txy%2F%3Fstreamname%3Dlive_293793435_1567354%26key%3D***",
            "provider": "txy"
        },
        "protocols": [
            {
                "protocol": "rtmp",
                "addr": "rtmp://txy.live-send.acg.tv/live-txy/",
                "code": "?streamname=live_293793435_1567354&key=***",
                "new_link": "http://tcdns.myqcloud.com:8086/bilibili_redirect?up_rtmp=txy.live-send.acg.tv%2Flive-txy%2F%3Fstreamname%3Dlive_293793435_1567354%26key%3D***",
                "provider": "txy"
            }
        ],
        "try_time": "0000-00-00 00:00:00",
        "live_key": "l:one:live:record:10352053:1589344980",
        "notice": {
            "type": 1,
            "status": 0,
            "title": "",
            "msg": "",
            "button_text": "",
            "button_url": ""
        }
    }
}

关闭直播

https://api.live.bilibili.com/room/v1/Room/stopLive

请求方式：POST

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中bili_jct的值正确并与csrf相同

正文参数（ application/x-www-form-urlencoded ）：

参数名	类型	内容	必要性	备注
room_id	num	直播间id	必要	必须为自己的直播间id
csrf	str	CSRF Token（位于cookie）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 65530：token错误（登录错误） -400：没有权限 （其他错误码有待补充）
msg	str	错误信息	默认为空
message	str	错误信息	默认为空
data	obj	信息本体

data对象：

字段	类型	内容	备注
change	num	是否改变状态	0：未改变 1：改变
status	str	PREPARING

示例：

关闭直播间10352053的直播

curl 'https://api.live.bilibili.com/room/v1/Room/stopLive' \
--data-urlencode 'room_id=10352053' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xxx'

查看响应示例：

{
    "code": 0,
    "msg": "",
    "message": "",
    "data": {
        "change": 1,
        "status": "PREPARING"
    }
}