bilibili-API-collect/docs/live/manage.html

172 lines
86 KiB
HTML
Raw Permalink Normal View History

2024-09-19 23:09:42 +08:00
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="generator" content="VuePress 2.0.0-beta.67">
<style>
:root {
--c-bg: #fff;
}
html.dark {
--c-bg: #22272e;
}
html, body {
background-color: var(--c-bg);
}
</style>
<script>
const userMode = localStorage.getItem('vuepress-color-scheme');
const systemDarkMode = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
if (userMode === 'dark' || (userMode !== 'light' && systemDarkMode)) {
document.documentElement.classList.toggle('dark', true);
}
</script>
<link rel="icon" href="/logo2.jpg"><title>直播间管理 | BAC Document</title><meta name="description" content="社区开源的第三方哔哩哔哩 API 文档">
<link rel="preload" href="/bilibili-API-collect/assets/style-a7819745.css" as="style"><link rel="stylesheet" href="/bilibili-API-collect/assets/style-a7819745.css">
<link rel="modulepreload" href="/bilibili-API-collect/assets/app-6ef24849.js"><link rel="modulepreload" href="/bilibili-API-collect/assets/manage.html-7f7fc93e.js"><link rel="modulepreload" href="/bilibili-API-collect/assets/manage.html-eebfa53f.js"><link rel="prefetch" href="/bilibili-API-collect/assets/CONTRIBUTING.html-5d94bebf.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-0d1d246d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-a1a3558c.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/splash.html-53855429.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/ver.html-b7ca0cfa.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-f7a47d1e.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-fecb6b5b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-6c04cf4d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/activity_list.html-b5ef105b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-c42e4c4d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-793787fd.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/recommend_author.html-3c1e94fe.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-ad3d1d10.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/articles.html-619e0082.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/category.html-c2e3b38d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-0ee7d366.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-2e89a343.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-b93efa81.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-418558e4.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/music_list.html-02cb5f36.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/musicstream_url.html-0b86e281.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/rank.html-4e3c963c.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/status_number.html-3b1e7ab4.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/follow.html-c3918f68.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-c8498357.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/timeline.html-0a3a89de.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/videostream_url.html-ecea5d0c.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/banlist.html-66dae847.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-8ea2447b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/video_room.html-6222ad7b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-3698858a.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/videostream_url.html-0a0e9cbe.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/ip.html-298243ad.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-6aa7eeb7.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-2971c414.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-4a9bcc52.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/railgun.html-3eebb2b8.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/season.html-a8ef16a3.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/statistics_data.html-bb56dc74.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/upload.html-1fd73832.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/videos.html-6d04
</head>
<body>
<div id="app"><!--[--><div class="theme-container"><!--[--><header class="navbar"><div class="toggle-sidebar-button" title="toggle sidebar" aria-expanded="false" role="button" tabindex="0"><div class="icon" aria-hidden="true"><span></span><span></span><span></span></div></div><span><a href="/bilibili-API-collect/" class=""><img class="logo" src="/bilibili-API-collect/logo2.jpg" alt="BAC Document"><span class="site-name can-hide">BAC Document</span></a></span><div class="navbar-items-wrapper" style=""><!--[--><!--]--><nav class="navbar-items can-hide"><!--[--><div class="navbar-item"><a href="/bilibili-API-collect/" class="" aria-label="首页"><!--[--><!--]--> 首页 <!--[--><!--]--></a></div><div class="navbar-item"><a href="/bilibili-API-collect/#🍴目录" class="" aria-label="目录"><!--[--><!--]--> 目录 <!--[--><!--]--></a></div><div class="navbar-item"><a href="/bilibili-API-collect/CONTRIBUTING.html" class="" aria-label="贡献指南"><!--[--><!--]--> 贡献指南 <!--[--><!--]--></a></div><div class="navbar-item"><div class="navbar-dropdown-wrapper"><button class="navbar-dropdown-title" type="button" aria-label="相关社群"><span class="title">相关社群</span><span class="arrow down"></span></button><button class="navbar-dropdown-title-mobile" type="button" aria-label="相关社群"><span class="title">相关社群</span><span class="right arrow"></span></button><ul style="display:none;" class="navbar-dropdown"><!--[--><li class="navbar-dropdown-item"><a class="external-link" href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&amp;k=ympvb3LAPT-Ulu3ezhGqbkJ8zXMKImOX&amp;authKey=z1KdkOdKO3wytN43m9K6On9nBtnDL4pAoD6VQHCipFBb9TasNDKuDHCmOE6TF3uc&amp;noverify=0&amp;group_code=191187164" rel="noopener noreferrer" target="_blank" aria-label="QQ交流群综合技术交流"><!--[--><!--]--> QQ交流群综合技术交流 <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></li><li class="navbar-dropdown-item"><a class="external-link" href="https://t.me/bilibili_API_collect_community" rel="noopener noreferrer" target="_blank" aria-label="Telegram交流群Github Bot推送"><!--[--><!--]--> Telegram交流群Github Bot推送 <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></li><!--]--></ul></div></div><div class="navbar-item"><a class="external-link" href="https://github.com/SocialSisterYi/bilibili-API-collect" rel="noopener noreferrer" target="_blank" aria-label="GitHub"><!--[--><!--]--> GitHub <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></div><!--]--></nav><!--[--><!--]--><button cl
--data-urlencode <span class="token string">&#39;platform=web&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;visit_id=&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf=xxx&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf_token=xxx&#39;</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-b</span> <span class="token string">&#39;SESSDATA=xxx;bili_jct=xx&#39;</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;0&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;ttl&quot;</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;roomID&quot;</span><span class="token operator">:</span> <span class="token string">&quot;1234&quot;</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">1531193016</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;已经创建直播间~&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;ttl&quot;</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;roomID&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="更新直播间标题" tabindex="-1"><a class="header-anchor" href="#更新直播间标题" aria-hidden="true">#</a> 更新直播间标题</h2><blockquote><p>https://api.live.bilibili.com/room/v1/Room/update</p></blockquote><p><em>请求方式POST</em></p><p>认证方式CookieSESSDATA</p><p>鉴权方式Cookie中<code>bili_jct</code>的值正确并与<code>csrf</code>相同</p><p><strong>正文参数( application/x-www-form-urlencoded </strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>room_id</td><td>num</td><td>直播间id</td><td>必要</td><td>必须为自己的直播间id</td></tr><tr><td>title</td><td>str</td><td>直播间标题</td><td></td><td>最大20字符</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token位于cookie</td><td>必要</td><td></td></tr><tr><td>csrf_token</td><td>str</td><td>CSRF Token位于 cookie</td><td></td><td></td></tr></tbody></table><p><strong>json回复</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0成功<br>65530token错误登录错误<br>1错误</td></tr><tr><td>msg</td><td>str</td><td>错误信息</td><td>默认为ok</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为ok</td></tr><tr><td>data</td><td>array</td><td></td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>修改直播间<code>10352053</code>标题为<code>测试</code></p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">&#39;https://api.live.bilibili.com/room/v1/Room/update&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;room_id=10352053&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;title=测试&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf=xxx&#39;</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-b</span> <span class="token string">&#39;SESSDATA=xxx;bili_jct=xx&#39;</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;msg&quot;</span><span class="token operator">:</span> <span class="token string">&quot;ok&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;ok&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">[</span><span class="token punctuation">]</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="开始直播" tabindex="-1"><a class="header-anchor" href="#开始直播" aria-hidden="true">#</a> 开始直播</h2><blockquote><p>https://api.live.bilibili.com/room/v1/Room/startLive</p></blockquote><p><em>请求方式POST</em></p><p>认证方式CookieSESSDATA</p><p>鉴权方式Cookie中<code>bili_jct</code>的值正确并与<code>csrf</code>相同</p><p>开播时必须有分区选择,开播后返回推流地址</p><p><strong>正文参数( application/x-www-form-urlencoded </strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>room_id</td><td>num</td><td>直播间id</td><td>必要</td><td>必须为自己的直播间id</td></tr><tr><td>area_v2</td><td>num</td><td>直播分区id子分区id</td><td>必要</td><td>详见<a href="/bilibili-API-collect/docs/live/live_area.html" class="">直播分区</a></td></tr><tr><td>platform</td><td>str</td><td>直播平台</td><td>必要</td><td>web端<br>bililinkandroid_link</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token位于cookie</td><td>必要</td><td></td></tr></tbody></table><p><strong>json回复</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0成功<br>65530token错误登录错误<br>1错误<br>60009分区不存在<br>60024: 目标分区需要人脸认证<br>60013非常抱歉您所在的地区受实名认证限制无法开播<br><strong>(其他错误码有待补充)</strong></td></tr><tr><td>msg</td><td>str</td><td>错误信息</td><td>默认为空</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为空</td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>change</td><td>num</td><td>是否改变状态</td><td>0未改变<br>1改变</td></tr><tr><td>status</td><td>str</td><td>LIVE</td><td></td></tr><tr><td>room_type</td><td>num</td><td>0</td><td>作用尚不明确</td></tr><tr><td>rtmp</td><td>obj</td><td>RTMP推流地址信息</td><td></td></tr><tr><td>protocols</td><td>array</td><td></td><td>作用尚不明确</td></tr><tr><td>try_time</td><td>str</td><td></td><td>作用尚不明确</td></tr><tr><td>live_key</td><td>str</td><td></td><td>作用尚不明确</td></tr><tr><td>notice</td><td>obj</td><td></td><td>作用尚不明确</td></tr></tbody></table><p><code>data</code>中的<code>rtmp</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>addr</td><td>str</td><td>RTMP推流发送地址</td><td><strong>重要</strong></td></tr><tr><td>code</td><td>str</td><td>RTMP推流参数密钥</td><td><strong>重要</strong></td></tr><tr><td>new_link</td><td>str</td><td>获取CDN推流ip地址重定向信息的url</td><td>没啥用</td></tr><tr><td>provider</td><td>str</td><td></td><td>作用尚不明确</td></tr></tbody></table><p><code>data</code>中的<code>protocols</code>数组:</p><table><thead><tr><th></th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>0</td><td>obj</td><td></td><td>作用尚不明确</td></tr></tbody></table><p><code>data</code>中的<code>protocols</code>数组中的对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>protocol</td><td>str</td><td>rtmp</td><td>作用尚不明确</td></tr><tr><td>addr</td><td>str</td><td>RTMP推流发送地址</td><td></td></tr><tr><td>co
--data-urlencode <span class="token string">&#39;room_id=10352053&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;area_v2=27&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;platform=pc&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf=xxx&#39;</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-b</span> <span class="token string">&#39;SESSDATA=xxx;bili_jct=xx&#39;</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;msg&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;change&quot;</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
<span class="token property">&quot;status&quot;</span><span class="token operator">:</span> <span class="token string">&quot;LIVE&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;room_type&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;rtmp&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;addr&quot;</span><span class="token operator">:</span> <span class="token string">&quot;rtmp://txy.live-send.acg.tv/live-txy/&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token string">&quot;?streamname=live_293793435_1567354&amp;key=***&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;new_link&quot;</span><span class="token operator">:</span> <span class="token string">&quot;http://tcdns.myqcloud.com:8086/bilibili_redirect?up_rtmp=txy.live-send.acg.tv%2Flive-txy%2F%3Fstreamname%3Dlive_293793435_1567354%26key%3D***&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;provider&quot;</span><span class="token operator">:</span> <span class="token string">&quot;txy&quot;</span>
<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token property">&quot;protocols&quot;</span><span class="token operator">:</span> <span class="token punctuation">[</span>
<span class="token punctuation">{</span>
<span class="token property">&quot;protocol&quot;</span><span class="token operator">:</span> <span class="token string">&quot;rtmp&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;addr&quot;</span><span class="token operator">:</span> <span class="token string">&quot;rtmp://txy.live-send.acg.tv/live-txy/&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token string">&quot;?streamname=live_293793435_1567354&amp;key=***&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;new_link&quot;</span><span class="token operator">:</span> <span class="token string">&quot;http://tcdns.myqcloud.com:8086/bilibili_redirect?up_rtmp=txy.live-send.acg.tv%2Flive-txy%2F%3Fstreamname%3Dlive_293793435_1567354%26key%3D***&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;provider&quot;</span><span class="token operator">:</span> <span class="token string">&quot;txy&quot;</span>
<span class="token punctuation">}</span>
<span class="token punctuation">]</span><span class="token punctuation">,</span>
<span class="token property">&quot;try_time&quot;</span><span class="token operator">:</span> <span class="token string">&quot;0000-00-00 00:00:00&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;live_key&quot;</span><span class="token operator">:</span> <span class="token string">&quot;l:one:live:record:10352053:1589344980&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;notice&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;type&quot;</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
<span class="token property">&quot;status&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;title&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;msg&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;button_text&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;button_url&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="关闭直播" tabindex="-1"><a class="header-anchor" href="#关闭直播" aria-hidden="true">#</a> 关闭直播</h2><blockquote><p>https://api.live.bilibili.com/room/v1/Room/stopLive</p></blockquote><p><em>请求方式POST</em></p><p>认证方式CookieSESSDATA</p><p>鉴权方式Cookie中<code>bili_jct</code>的值正确并与<code>csrf</code>相同</p><p><strong>正文参数( application/x-www-form-urlencoded </strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>room_id</td><td>num</td><td>直播间id</td><td>必要</td><td>必须为自己的直播间id</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token位于cookie</td><td>必要</td><td></td></tr></tbody></table><p><strong>json回复</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0成功<br>65530token错误登录错误<br>-400没有权限<br><strong>(其他错误码有待补充)</strong></td></tr><tr><td>msg</td><td>str</td><td>错误信息</td><td>默认为空</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为空</td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>change</td><td>num</td><td>是否改变状态</td><td>0未改变<br>1改变</td></tr><tr><td>status</td><td>str</td><td>PREPARING</td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>关闭直播间<code>10352053</code>的直播</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">&#39;https://api.live.bilibili.com/room/v1/Room/stopLive&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;room_id=10352053&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf=xxx&#39;</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-b</span> <span class="token string">&#39;SESSDATA=xxx;bili_jct=xxx&#39;</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;msg&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;change&quot;</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
<span class="token property">&quot;status&quot;</span><span class="token operator">:</span> <span class="token string">&quot;PREPARING&quot;</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="更新直播间公告" tabindex="-1"><a class="header-anchor" href="#更新直播间公告" aria-hidden="true">#</a> 更新直播间公告</h2><blockquote><p>https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews</p></blockquote><p><em>请求方式POST</em></p><p>认证方式CookieSESSDATA</p><p>鉴权方式Cookie中<code>bili_jct</code>的值正确并与<code>csrf</code>相同</p><p><strong>正文参数( application/x-www-form-urlencoded </strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>room_id</td><td>num</td><td>直播间id</td><td>必要</td><td>必须为自己的直播间id</td></tr><tr><td>uid</td><td>num</td><td>用户id</td><td>必要</td><td></td></tr><tr><td>content</td><td>str</td><td>公告内容</td><td>必要</td><td>最大60个字符,可以为空</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token位于cookie</td><td>必要</td><td></td></tr><tr><td>csrf_token</td><td>str</td><td>CSRF Token位于 cookie</td><td></td><td></td></tr></tbody></table><p><strong>json回复</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0成功<br>65530token错误登录错误<br>1错误</td></tr><tr><td>data</td><td>array</td><td></td><td></td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为ok</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td>作用尚不明确</td></tr></tbody></table><p><strong>示例:</strong></p><p>修改直播间<code>11996900</code>公告为<code>测试修改公告</code></p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">&#39;https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;room_id=11996900&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;uid=306903238&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;content=测试修改公告&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf_token=xxx&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf=xxx&#39;</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-b</span> <span class="token string">&#39;SESSDATA=xxx;bili_jct=xxx&#39;</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;0&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;ttl&quot;</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span><span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="编辑直播间标签" tabindex="-1"><a class="header-anchor" href="#编辑直播间标签" aria-hidden="true">#</a> 编辑直播间标签</h2><blockquote><p>https://api.live.bilibili.com/room/v1/Room/update</p></blockquote><p><em>请求方式POST</em></p><p>认证方式CookieSESSDATA</p><p>鉴权方式Cookie中<code>bili_jct</code>的值正确并与<code>csrf</code>相同</p><p><strong>正文参数( application/x-www-form-urlencoded </strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>room_id</td><td>num</td><td>直播间id</td><td>必要</td><td>必须为自己的直播间id</td></tr><tr><td>add_tag</td><td>str</td><td>要添加的标签</td><td>必要</td><td>最大10个字符</td></tr><tr><td>del_tag</td><td>str</td><td>要删除的标签</td><td>必要</td><td></td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token位于cookie</td><td>必要</td><td></td></tr><tr><td>csrf_token</td><td>str</td><td>CSRF Token位于 cookie</td><td></td><td></td></tr></tbody></table><p><strong>json回复</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0成功<br>65530token错误登录错误<br>1错误</td></tr><tr><td>data</td><td>obj</td><td></td><td></td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为ok</td></tr><tr><td>msg</td><td>str</td><td>错误信息</td><td>默认为ok</td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>audit_info</td><td>obj</td><td></td><td></td></tr><tr><td>sub_session_key</td><td>str</td><td></td><td></td></tr></tbody></table><p><code>data</code>中的<code>audit_info</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>audit_title_reason</td><td>str</td><td></td><td></td></tr><tr><td>audit_title_status</td><td>num</td><td>0</td><td></td></tr><tr><td>update_title</td><td>str</td><td></td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>给直播间<code>11996900</code>添加一个标签为<code>测试标签</code></p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">&#39;https://api.live.bilibili.com/room/v1/Room/update&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;room_id=11996900&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;add_tag=测试标签&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf_token=xxx&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf=xxx&#39;</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-b</span> <span class="token string">&#39;SESSDATA=xxx;bili_jct=xxx&#39;</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;msg&quot;</span><span class="token operator">:</span> <span class="token string">&quot;ok&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;ok&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;sub_session_key&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;audit_info&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;audit_title_reason&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;update_title&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;audit_title_status&quot;</span><span class="token operator">:</span> <span class="token number">0</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><p>给直播间<code>11996900</code>删除内容为<code>测试标签</code>的标签</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">&#39;https://api.live.bilibili.com/room/v1/Room/update&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;room_id=11996900&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;del_tag=测试标签&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf_token=xxx&#39;</span> <span class="token punctuation">\</span>
--data-urlencode <span class="token string">&#39;csrf=xxx&#39;</span> <span class="token punctuation">\</span>
<span class="token parameter variable">-b</span> <span class="token string">&#39;SESSDATA=xxx;bili_jct=xxx&#39;</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
<span class="token property">&quot;code&quot;</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
<span class="token property">&quot;msg&quot;</span><span class="token operator">:</span> <span class="token string">&quot;ok&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;message&quot;</span><span class="token operator">:</span> <span class="token string">&quot;ok&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;data&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;sub_session_key&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;audit_info&quot;</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">&quot;audit_title_reason&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;update_title&quot;</span><span class="token operator">:</span> <span class="token string">&quot;&quot;</span><span class="token punctuation">,</span>
<span class="token property">&quot;audit_title_status&quot;</span><span class="token operator">:</span> <span class="token number">0</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details></div><!--[--><!--]--></div><footer class="page-meta"><div class="meta-item edit-link"><a class="external-link meta-item-label" href="https://github.com/SocialSisterYi/bilibili-API-collect/edit/master/docs/live/manage.md" rel="noopener noreferrer" target="_blank" aria-label="在 GitHub 上编辑此页"><!--[--><!--]--> 在 GitHub 上编辑此页 <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></div><!----><!----></footer><!----><!--[--><!--[--><footer style="text-align:center;"> Copyright © 2020-2024 <a href="https://github.com/SocialSisterYi/">SocialSisterYi</a> | <a href="https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/LICENSE">CC-BY-NC-4.0 Licensed</a></footer><!--]--><!--]--></main><!--]--></div><!----><!--]--></div>
<script type="module" src="/bilibili-API-collect/assets/app-6ef24849.js" defer></script>
</body>
</html>