直播间管理-哔哩哔哩直播间 API

  • 2020 年 07 月 10 日
  • 516
  • 683 字
  • 33 条评论

直播间管理

本页所有操作均需登录(SESSDATA)

更新直播间标题

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

方式:POST

还需验证 cookie 中 bili_jct 的值正确并与 csrf 相同

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
room_idnum直播间 ID必要必须为自己的直播间 ID
titlestr直播间标题必要最大 20 字符
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 65530:token 错误(登录错误) 1:错误
msgstr错误信息默认为 ok
messagestr错误信息默认为 ok
dataarray

示例:

修改直播间 10352053 标题为测试

curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&title=%E6%B5%8B%E8%AF%95" "http://api.live.bilibili.com/room/v1/Room/update"

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

开始直播

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

方式:POST

还需验证 cookie 中 bili_jct 的值正确并与 csrf 相同

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

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
room_idnum直播间 ID必要必须为自己的直播间 ID
area_v2num直播分区 ID(子分区 ID)必要详见直播分区
platformstr必须为 pc必要
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 65530:token 错误(登录错误) 1:错误 60009:分区不存在 (其他错误码有待补充)
msgstr错误信息默认为空
messagestr错误信息默认为空
dataobj信息本体

data 对象:

字段类型内容备注
changenum是否改变状态0:未改变 1:改变
statusstrLIVE
room_typenum0作用尚不明确
rtmpobjRTMP 推流地址信息
protocolssrrary???作用尚不明确
try_timestr???作用尚不明确
live_keystr???作用尚不明确
noticeobj???作用尚不明确

data 中的 rtmp 对象:

字段类型内容备注
addrstrRTMP 推流(发送)地址重要
codestrRTMP 推流参数(密钥)重要
new_linkstr获取 CDN 推流 ip 地址重定向信息的 url没啥用
providerstr???作用尚不明确

data 中的 protocols 数组:

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

data 中的 protocols 数组中的对象:

字段类型内容备注
protocolstrrtmp作用尚不明确
addrstrRTMP 推流(发送)地址
codestrRTMP 推流参数(密钥)
new_linkstr获取 CDN 推流 ip 地址重定向信息的 url
providerstrtxy作用尚不明确

data 中的 notice 对象:

字段类型内容备注
typenum1作用尚不明确
statusnum0作用尚不明确
titlestr作用尚不明确
msgstr作用尚不明确
button_textstr作用尚不明确
button_urlstr作用尚不明确

示例:

27 作为分区 ID 开播直播间 10352053

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

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

curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&area_v2=27&platform=pc&csrf=xxx" "http://api.live.bilibili.com/room/v1/Room/startLive"

{
    "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": ""
        }
    }
}

关闭直播

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

方式:POST

还需验证 cookie 中 bili_jct 的值正确并与 csrf 相同

正文参数( application/x-www-form-urlencoded ):

参数名类型内容必要性备注
room_idnum直播间 ID必要必须为自己的直播间 ID
csrfstrCSRF Token(位于 cookie)必要

json 回复:

根对象:

字段类型内容备注
codenum返回值0:成功 65530:token 错误(登录错误) -400:没有权限 (其他错误码有待补充)
msgstr错误信息默认为空
messagestr错误信息默认为空
dataobj信息本体

data 对象:

字段类型内容备注
changenum是否改变状态0:未改变 1:改变
statusstrPREPARING

示例:

关闭直播间 10352053 的直播

curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&csrf=xxx" "http://api.live.bilibili.com/room/v1/Room/stopLive"

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

原文地址:https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/live/manage.md


版权属于:Aini99

本文链接:https://bv-av.cn/read/cv21

本站部分内容转载于互联网,目的是为了传达信息。如果有内容侵犯了你的版权,请联系 QQ:1144560054。我们会在审查后第一时间进行修改。


—— 收到 33 条评论 ——

评论已关闭