204 lines
80 KiB
JavaScript
204 lines
80 KiB
JavaScript
import{_ as d,c as p,a as l,b as s,d as n,e,w as o,r,o as i}from"./app-Dgsdh8A6.js";const c={};function u(D,t){const a=r("RouteLink");return i(),p("div",null,[t[30]||(t[30]=l(`<h1 id="直播间管理" tabindex="-1"><a class="header-anchor" href="#直播间管理"><span>直播间管理</span></a></h1><h2 id="开通直播间" tabindex="-1"><a class="header-anchor" href="#开通直播间"><span>开通直播间</span></a></h2><blockquote><p>https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:Cookie(SESSDATA)</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>platform</td><td>str</td><td>客户端?</td><td>必要</td><td>默认值web</td></tr><tr><td>visit_id</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>1531193016:已经创建直播间~<br>-400:请求错误</td></tr><tr><td>ttl</td><td>str</td><td>错误信息</td><td>默认为1</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>data</td><td>array</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>roomID</td><td>str</td><td>直播间房间号</td><td>创建成功返回直播间号</td></tr></tbody></table><p><strong>示例:</strong></p><p>开通直播间</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'platform=web'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'visit_id='</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'csrf_token=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">-b </span><span style="color:#CE9178;">'SESSDATA=xxx;bili_jct=xx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"0"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "ttl"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "roomID"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"1234"</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1531193016</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"已经创建直播间~"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "ttl"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "roomID"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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="#更新直播间信息"><span>更新直播间信息</span></a></h2><blockquote><p>https://api.live.bilibili.com/room/v1/Room/update</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:Cookie(SESSDATA)</p><p>鉴权方式:Cookie中<code>bili_jct</code>的值正确并与<code>csrf</code>相同</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p>`,23)),s("table",null,[t[14]||(t[14]=s("thead",null,[s("tr",null,[s("th",null,"参数名"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"必要性"),s("th",null,"备注")])],-1)),s("tbody",null,[t[6]||(t[6]=s("tr",null,[s("td",null,"csrf"),s("td",null,"str"),s("td",null,"CSRF Token(位于cookie)"),s("td",null,"必要"),s("td")],-1)),t[7]||(t[7]=s("tr",null,[s("td",null,"csrf_token"),s("td",null,"str"),s("td",null,"CSRF Token(位于 cookie)"),s("td",null,"非必要"),s("td")],-1)),t[8]||(t[8]=s("tr",null,[s("td",null,"platform"),s("td",null,"str"),s("td",null,"平台标识"),s("td",null,"非必要"),s("td")],-1)),t[9]||(t[9]=s("tr",null,[s("td",null,"visit_id"),s("td",null,"str"),s("td",null,"(?)"),s("td",null,"非必要"),s("td",null,"某种标识?")],-1)),t[10]||(t[10]=s("tr",null,[s("td",null,"room_id"),s("td",null,"num"),s("td",null,"直播间id"),s("td",null,"必要"),s("td",null,"必须为自己的直播间id")],-1)),t[11]||(t[11]=s("tr",null,[s("td",null,"title"),s("td",null,"str"),s("td",null,"直播间标题"),s("td",null,"非必要"),s("td",null,"上限40个字符")],-1)),s("tr",null,[t[2]||(t[2]=s("td",null,"area_id",-1)),t[3]||(t[3]=s("td",null,"num",-1)),t[4]||(t[4]=s("td",null,"直播分区id(子分区id)",-1)),t[5]||(t[5]=s("td",null,"非必要",-1)),s("td",null,[t[1]||(t[1]=n("详见")),e(a,{to:"/docs/live/live_area.html"},{default:o(()=>t[0]||(t[0]=[n("直播分区")])),_:1,__:[0]})])]),t[12]||(t[12]=s("tr",null,[s("td",null,"add_tag"),s("td",null,"str"),s("td",null,"要添加的标签"),s("td",null,"非必要"),s("td",null,"开播设置界面上限10个字符")],-1)),t[13]||(t[13]=s("tr",null,[s("td",null,"del_tag"),s("td",null,"str"),s("td",null,"要删除的标签"),s("td",null,"非必要"),s("td",null,[n("若存在"),s("code",null,"add_tag"),n("时不起作用")])],-1))])]),t[31]||(t[31]=l(`<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>-1:操作太频繁<br>1:错误<br>3:未登录或鉴权失败<br>405:不允许的请求方法<br>60009:分区已下线<br>65530:token错误(登录错误)<br></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>obj</td><td>信息本体</td><td>部分失败情况下是<code>[]</code>(空数组)</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>sub_session_key</td><td>str</td><td>信息变动标识</td><td></td></tr><tr><td>audit_info</td><td>obj</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>标题审核状态</td><td></td></tr><tr><td>audit_title</td><td>str</td><td>被审核的标题</td><td>更新标题时存在</td></tr><tr><td>update_title</td><td>str</td><td><code>""</code></td><td>作用尚不明确</td></tr></tbody></table><p><strong>示例:</strong></p><p>修改直播间<code>10352053</code>标题为<code>测试</code></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/room/v1/Room/update'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'room_id=10352053'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'title=测试'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> -b</span><span style="color:#CE9178;"> 'SESSDATA=xxx;bili_jct=xx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">:</span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "msg"</span><span style="color:#D4D4D4;">:</span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">:</span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "sub_session_key"</span><span style="color:#D4D4D4;">:</span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_info"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_reason"</span><span style="color:#D4D4D4;">:</span><span style="color:#CE9178;">"先发后审"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "update_title"</span><span style="color:#D4D4D4;">:</span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_status"</span><span style="color:#D4D4D4;">:</span><span style="color:#B5CEA8;">2</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title"</span><span style="color:#D4D4D4;">:</span><span style="color:#CE9178;">"测试"</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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><p>修改直播间<code>10352053</code>分区为<code>40</code></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/room/v1/Room/update'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'room_id=10352053'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'area_id=40'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> -b</span><span style="color:#CE9178;"> 'SESSDATA=xxx;bili_jct=xx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "msg"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "sub_session_key"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_info"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_reason"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "update_title"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_status"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/room/v1/Room/update'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'room_id=11996900'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'add_tag=测试标签'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> -b</span><span style="color:#CE9178;"> 'SESSDATA=xxx;bili_jct=xxx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "msg"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "sub_session_key"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_info"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_reason"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "update_title"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_status"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/room/v1/Room/update'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'room_id=11996900'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'del_tag=测试标签'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> -b</span><span style="color:#CE9178;"> 'SESSDATA=xxx;bili_jct=xxx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "msg"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"ok"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "sub_session_key"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_info"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_reason"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "update_title"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_status"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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="#开始直播"><span>开始直播</span></a></h2><blockquote><p>https://api.live.bilibili.com/room/v1/Room/startLive</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:Cookie(SESSDATA)</p><p>鉴权方式:Cookie中<code>bili_jct</code>的值正确并与<code>csrf</code>相同</p><p>开播时必须有分区选择,开播后返回推流地址</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p>`,27)),s("table",null,[t[29]||(t[29]=s("thead",null,[s("tr",null,[s("th",null,"参数名"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"必要性"),s("th",null,"备注")])],-1)),s("tbody",null,[t[21]||(t[21]=s("tr",null,[s("td",null,"room_id"),s("td",null,"num"),s("td",null,"直播间id"),s("td",null,"必要"),s("td",null,"必须为自己的直播间 id")],-1)),s("tr",null,[t[17]||(t[17]=s("td",null,"area_v2",-1)),t[18]||(t[18]=s("td",null,"num",-1)),t[19]||(t[19]=s("td",null,"直播分区id(子分区 id)",-1)),t[20]||(t[20]=s("td",null,"必要",-1)),s("td",null,[t[16]||(t[16]=n("详见")),e(a,{to:"/docs/live/live_area.html"},{default:o(()=>t[15]||(t[15]=[n("直播分区")])),_:1,__:[15]})])]),t[22]||(t[22]=s("tr",null,[s("td",null,"platform"),s("td",null,"str"),s("td",null,"直播平台"),s("td",null,"必要"),s("td",null,[n("可选值:"),s("code",null,"pc"),n("、"),s("code",null,"pc_link"),n(" (直播姬 PC), "),s("code",null,"android_link"),n(" (直播姬 Android)")])],-1)),t[23]||(t[23]=s("tr",null,[s("td",null,"csrf"),s("td",null,"str"),s("td",null,"CSRF Token(位于 cookie)"),s("td",null,"必要"),s("td")],-1)),t[24]||(t[24]=s("tr",null,[s("td",null,"csrf_token"),s("td",null,"str"),s("td",null,"CSRF Token(位于 cookie)"),s("td",null,"非必要"),s("td")],-1)),t[25]||(t[25]=s("tr",null,[s("td",null,"version"),s("td",null,"str"),s("td",null,"直播姬版本号"),s("td",null,"非必要"),s("td",null,[n("建议与 "),s("code",null,"build"),n(" 一同提供,详见下方说明。可从"),s("a",{href:"#%E7%9B%B4%E6%92%AD%E5%A7%AC%E7%89%88%E6%9C%AC%E5%8F%B7%E8%8E%B7%E5%8F%96"},"直播姬版本号获取"),n("接口获得。")])],-1)),t[26]||(t[26]=s("tr",null,[s("td",null,"build"),s("td",null,"num"),s("td",null,"直播姬构建号"),s("td",null,"非必要"),s("td",null,[n("建议与 "),s("code",null,"version"),n(" 一同提供。")])],-1)),t[27]||(t[27]=s("tr",null,[s("td",null,"appkey"),s("td",null,"str"),s("td",null,"APP密钥"),s("td",null,"条件性必要"),s("td",null,"特定情况下必要,详见下方说明。")],-1)),t[28]||(t[28]=s("tr",null,[s("td",null,"sign"),s("td",null,"str"),s("td",null,"APP API签名得到的 sign"),s("td",null,"条件性必要"),s("td",null,"特定情况下必要,详见下方说明。")],-1))])]),t[32]||(t[32]=l(`<p><strong>说明</strong>: 截止至 2025 年 7 月 20 日,部分账户不提供 <code>version</code> <code>build</code> <code>appkey</code> <code>sign</code> 也可获取推流码,部分账户会返回 <code>60024</code> (需要人脸认证),此时请尝试提供 <code>version</code> <code>build</code>,目前似乎没有校验,提供了就可以。(比如 <code>version:1.0.0</code> <code>build:1234</code>) 如果仍然返回 <code>60024</code>,请尝试提供 <code>appkey</code> <code>sign</code> 参数。如果你的 <code>version</code> 和 <code>build</code> 为 <code>7.19.0.9432</code> 和 <code>9432</code>,必须提供 <code>appkey</code> <code>sign</code>。</p><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>-400: 请求错误<br>1: 错误<br>60009: 分区不存在<br>60013: 所在地区受实名认证限制无法开播<br>60024: 目标分区需要人脸认证<br>60034: 系统维护仅支持直播姬开播<br>60037: web在线开播已下线<br>65530: token错误 (登录失效)<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>直播间状态</td><td><code>LIVE</code></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>推流协议、地址、密钥等信息<br>其中地址、密钥与 <code>rtmp</code> 字段的内容是一致的</td><td>协议只见到过 <code>rtmp</code></td></tr><tr><td>try_time</td><td>str</td><td>???</td><td>作用尚不明确</td></tr><tr><td>live_key</td><td>str</td><td>标记直播场次的key</td><td></td></tr><tr><td>sub_session_key</td><td>str</td><td>信息变动标识</td><td></td></tr><tr><td>notice</td><td>obj</td><td>???</td><td>作用尚不明确</td></tr><tr><td>qr</td><td>str</td><td><code>""</code></td><td>作用尚不明确</td></tr><tr><td>need_face_auth</td><td>bool</td><td>需要人脸识别?</td><td>作用尚不明确</td></tr><tr><td>service_source</td><td>str</td><td>???</td><td>作用尚不明确</td></tr><tr><td>rtmp_backup</td><td>null</td><td>???</td><td>作用尚不明确</td></tr><tr><td>up_stream_extra</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><code>txy</code>: 腾讯云</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>与 <code>rtmp</code> 字段在地址和密钥上相同的推流协议信息</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>格式为 <code>rtmp://<推流节点>/live-bvc/</code></td></tr><tr><td>code</td><td>str</td><td>RTMP推流参数(密钥)</td><td>格式为 <code>?streamname=live_<B站UID>_<未知数字>&key=<密钥>&schedule=rtmp&pflag=<开播平台标志></code></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><code>txy</code>: 腾讯云</td></tr></tbody></table><p><code>data</code>中的<code>notice</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>type</td><td>num</td><td>1</td><td>作用尚不明确</td></tr><tr><td>status</td><td>num</td><td>0</td><td>作用尚不明确</td></tr><tr><td>title</td><td>str</td><td>空</td><td>作用尚不明确</td></tr><tr><td>msg</td><td>str</td><td>空</td><td>作用尚不明确</td></tr><tr><td>button_text</td><td>str</td><td>空</td><td>作用尚不明确</td></tr><tr><td>button_url</td><td>str</td><td>空</td><td>作用尚不明确</td></tr></tbody></table><p><code>data</code>中的<code>up_stream_extra</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>isp</td><td>str</td><td>主播的互联网服务提供商</td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>以<code>27</code>作为分区id开播直播间<code>10352053</code></p><p>其中<code>"data"."rtmp"."addr"</code>为推流地址</p><p><code>"data"."rtmp"."code"</code>为推流参数</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/room/v1/Room/startLive'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'room_id=10352053'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'area_v2=27'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'platform=pc'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">-b </span><span style="color:#CE9178;">'SESSDATA=xxx;bili_jct=xx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "change"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "status"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"LIVE"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "try_time"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"0000-00-00 00:00:00"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "room_type"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "live_key"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"608336837537435443"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "sub_session_key"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"608336837537435443sub_time:1747292297"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "rtmp"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "type"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "addr"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"rtmp://live-push.bilivideo.com/live-bvc/"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"?streamname=live_348892132_32373699</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">key=e03061d4a7529d8eaa322dc4d330ca1c</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">schedule=rtmp</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">pflag=11"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "new_link"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"https://core.bilivideo.com/video/uplinkcore/selfbuild/schedule?up_rtmp=live-push.bilivideo.com%2Flive-bvc%2F%3Fstreamname%3Dlive_348892132_32373699%26key%3De73061d8a7539d8eaa233dc4d880ca1c%26schedule%3Drtmp%26pflag%3D11</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">edge=edge"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "provider"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"live"</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> },</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "protocols"</span><span style="color:#D4D4D4;">:[</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "protocol"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"rtmp"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "addr"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"rtmp://live-push.bilivideo.com/live-bvc/"</span><span style="color:#D4D4D4;">,</span><span style="color:#9CDCFE;">"code"</span><span style="color:#D4D4D4;">:</span><span style="color:#CE9178;">"?streamname=live_348892132_32373699</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">key=e73061d4a1002d8eaa322dc4d880ca1c</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">schedule=rtmp</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">pflag=11"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "new_link"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"https://core.bilivideo.com/video/uplinkcore/selfbuild/schedule?up_rtmp=live-push.bilivideo.com%2Flive-bvc%2F%3Fstreamname%3Dlive_348892132_32373699%26key%3De10298d4a7539d8eaa322dc4d220ca1c%26schedule%3Drtmp%26pflag%3D11</span><span style="color:#D7BA7D;">\\u0026</span><span style="color:#CE9178;">edge=edge"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "provider"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"txy"</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> ],</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "notice"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "type"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "status"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "title"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "msg"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "button_text"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "button_url"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> },</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "qr"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "need_face_auth"</span><span style="color:#D4D4D4;">: </span><span style="color:#569CD6;">false</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "service_source"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"live-streaming"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "rtmp_backup"</span><span style="color:#D4D4D4;">: </span><span style="color:#569CD6;">null</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "up_stream_extra"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "isp"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"电信"</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> },</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "msg"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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 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="#关闭直播"><span>关闭直播</span></a></h2><blockquote><p>https://api.live.bilibili.com/room/v1/Room/stopLive</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:Cookie(SESSDATA)</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>platform</td><td>str</td><td>直播平台</td><td>必要</td><td>直播姬(pc):pc_link<br>直播姬(android):android_link</td></tr><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>65530:token错误(登录错误)<br>-400:没有权限<br>60034: 系统维护仅支持直播姬关播<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>直播间状态</td><td><code>PREPARING</code>、<code>ROUND</code></td></tr></tbody></table><p><strong>示例:</strong></p><p>关闭直播间<code>10352053</code>的直播</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/room/v1/Room/stopLive'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'platform=pc_link'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'room_id=10352053'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> -b</span><span style="color:#CE9178;"> 'SESSDATA=xxx;bili_jct=xxx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "msg"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "change"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "status"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"PREPARING"</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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="#预更新直播间信息"><span>预更新直播间信息</span></a></h2><blockquote><p>https://api.live.bilibili.com/xlive/app-blink/v1/preLive/UpdatePreLiveInfo</p></blockquote><p><em>请求方法: POST</em></p><p>认证方式:Cookie(SESSDATA)</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>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><tr><td>platform</td><td>str</td><td>平台标识</td><td>必要</td><td>似乎可随意提供<br>网页端: web</td></tr><tr><td>mobi_app</td><td>str</td><td>平台标识?</td><td>必要</td><td>似乎可随意提供<br>网页端: web</td></tr><tr><td>build</td><td>num</td><td>构建标识?</td><td>必要</td><td>建议取<code>1</code>,似乎可随意提供</td></tr><tr><td>cover</td><td>str</td><td>直播封面链接</td><td>非必要</td><td>图片链接需要在<code>.hdslb.com</code>域名下</td></tr><tr><td>title</td><td>str</td><td>直播间标题</td><td>非必要</td><td>参见<a href="#%E6%9B%B4%E6%96%B0%E7%9B%B4%E6%92%AD%E9%97%B4%E4%BF%A1%E6%81%AF">更新直播间信息</a>的title参数</td></tr><tr><td>coverVertical</td><td>str</td><td>(?)</td><td>非必要</td><td>作用尚不明确</td></tr><tr><td>liveDirectionType</td><td>num</td><td>(?)</td><td>非必要</td><td><code>1</code></td></tr><tr><td>visit_id</td><td>str</td><td>(?)</td><td>非必要</td><td><code>""</code></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>1: 错误<br>100402: 图片地址不合法</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>成功时为<code>"0"</code></td></tr><tr><td>ttl</td><td>num</td><td><code>1</code></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>audit_info</td><td>obj</td><td>审核信息</td><td></td></tr></tbody></table><p><code>data.audit_info</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>audit_title</td><td>str</td><td>被审核的标题</td><td></td></tr><tr><td>audit_title_status</td><td>num</td><td>标题审核状态</td><td></td></tr><tr><td>audit_title_reason</td><td>str</td><td>标题审核提示</td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>更新直播间封面</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/UpdatePreLiveInfo'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'platform=web'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'mobi_app=web'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'build=1'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'cover=https://i0.hdslb.com/bfs/live/59fc254c1f51a962dbf69ae85e4920f2f6fb8dcd.png'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> -b</span><span style="color:#CE9178;"> 'SESSDATA=xxx;bili_jct=xxx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"0"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "ttl"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_info"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_status"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_reason"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">""</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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>使用此接口更新直播间标题</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/UpdatePreLiveInfo'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'platform=web'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'mobi_app=web'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'build=1'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'title=你好你好,我是花火~咱们来找点乐子吧?小灰毛,不要害羞嘛,要大胆的来,一起欢愉吧'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> --data-urlencode</span><span style="color:#CE9178;"> 'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#569CD6;"> -b</span><span style="color:#CE9178;"> 'SESSDATA=xxx;bili_jct=xxx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"0"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "ttl"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_info"</span><span style="color:#D4D4D4;">:{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"你好你好,我是花火~咱们来找点乐子吧?小灰毛,不要害羞嘛,要大胆的来,一起欢愉吧"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_status"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">2</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "audit_title_reason"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"先发后审"</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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="#更新直播间公告"><span>更新直播间公告</span></a></h2><blockquote><p>https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:Cookie(SESSDATA)</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>65530:token错误(登录错误)<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-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'room_id=11996900'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'uid=306903238'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'content=测试修改公告'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'csrf_token=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">--data-urlencode </span><span style="color:#CE9178;">'csrf=xxx'</span><span style="color:#D7BA7D;"> \\</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">-b </span><span style="color:#CE9178;">'SESSDATA=xxx;bili_jct=xxx'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"0"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "ttl"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {}</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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="pc直播姬版本号获取" tabindex="-1"><a class="header-anchor" href="#pc直播姬版本号获取"><span>PC直播姬版本号获取</span></a></h2><blockquote><p>https://api.live.bilibili.com/xlive/app-blink/v1/liveVersionInfo/getHomePageLiveVersion</p></blockquote><p><em>请求方式:GET</em></p><p>认证方式:无</p><p>鉴权方式:无</p><p><strong>请求参数 (Query):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>appkey</td><td>str</td><td>APP密钥</td><td>不必要</td><td>使用PC投稿工具的appkey和appsec</td></tr><tr><td>sign</td><td>str</td><td>APP API签名得到的sign</td><td>不必要</td><td></td></tr><tr><td>system_version</td><td>num</td><td>暂不清楚</td><td>必要</td><td>可以直接写2</td></tr><tr><td>ts</td><td>num</td><td>10位时间戳</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>-400:请求错误</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</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>curr_version</td><td>str</td><td>直播姬最新版本号</td><td></td></tr><tr><td>build</td><td>num</td><td>直播姬构建号</td><td></td></tr><tr><td>instruction</td><td>str</td><td>更新说明(简要)</td><td></td></tr><tr><td>file_size</td><td>str</td><td>文件大小(字节)</td><td></td></tr><tr><td>file_md5</td><td>str</td><td>安装包文件MD5</td><td></td></tr><tr><td>content</td><td>str</td><td>HTML格式的更新内容</td><td></td></tr><tr><td>download_url</td><td>str</td><td>安装包下载链接</td><td></td></tr><tr><td>hdiffpatch_switch</td><td>num</td><td>增量更新开关?</td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>获取直播姬最新版本信息</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-shell"><span class="line"><span style="color:#DCDCAA;">curl</span><span style="color:#CE9178;"> 'https://api.live.bilibili.com/xlive/app-blink/v1/liveVersionInfo/getHomePageLiveVersion?appkey=aae92bc66f3edfab&sign=49d289e3ad34c509cc66fbee1c0affec&system_version=2&ts=1752971145'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" style="background-color:#1E1E1E;color:#D4D4D4;"><pre class="shiki dark-plus vp-code"><code class="language-json"><span class="line"><span style="color:#D4D4D4;">{</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "code"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">0</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "message"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"0"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "ttl"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "data"</span><span style="color:#D4D4D4;">: {</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "curr_version"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"7.19.0.9432"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "build"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">9432</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "instruction"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"</span><span style="color:#D7BA7D;">\\u3010\\u65b0\\u589e\\u3011\\u65b0\\u589e\\u7f8e\\u989c\\u8c03\\u6574\\u5165\\u53e3\\n\\u3010\\u4f18\\u5316\\u3011\\u5df2\\u77e5\\u95ee\\u9898\\u4f18\\u5316</span><span style="color:#CE9178;">"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "file_size"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"300867136"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "file_md5"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"e1619a8e2603aa94b58a58121f94403f"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "content"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"<p></span><span style="color:#D7BA7D;">\\u3010\\u65b0\\u589e\\u3011\\u65b0\\u589e\\u7f8e\\u989c\\u8c03\\u6574\\u5165\\u53e3</span><span style="color:#CE9178;"><br></span><span style="color:#D7BA7D;">\\u3010\\u4f18\\u5316\\u3011\\u5df2\\u77e5\\u95ee\\u9898\\u4f18\\u5316</span><span style="color:#CE9178;"></p><p></p><p><br></p>"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "download_url"</span><span style="color:#D4D4D4;">: </span><span style="color:#CE9178;">"https://dl.hdslb.com/bili/bililive/win/Livehime-Win-beta-7.19.0.9432-x64.exe"</span><span style="color:#D4D4D4;">,</span></span>
|
||
<span class="line"><span style="color:#9CDCFE;"> "hdiffpatch_switch"</span><span style="color:#D4D4D4;">: </span><span style="color:#B5CEA8;">1</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;"> }</span></span>
|
||
<span class="line"><span style="color:#D4D4D4;">}</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><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>`,89))])}const m=d(c,[["render",u]]),b=JSON.parse('{"path":"/docs/live/manage.html","title":"直播间管理","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1754477495000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"},{"name":"NoahCodeGG","username":"NoahCodeGG","email":"51156988+NoahCodeGG@users.noreply.github.com","commits":1,"url":"https://github.com/NoahCodeGG"},{"name":"LaMerChiang","username":"LaMerChiang","email":"catlair@qq.com","commits":2,"url":"https://github.com/LaMerChiang"},{"name":"jaxMineKa","username":"jaxMineKa","email":"153351521+jaxMineKa@users.noreply.github.com","commits":1,"url":"https://github.com/jaxMineKa"},{"name":"Kro","username":"Kro","email":"Admin@fungit.org","commits":1,"url":"https://github.com/Kro"},{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":1,"url":"https://github.com/SessionHu"},{"name":"YuHuanTin","username":"YuHuanTin","email":"51024916+YuHuanTin@users.noreply.github.com","commits":1,"url":"https://github.com/YuHuanTin"},{"name":"pskdje","username":"pskdje","email":"77605497+pskdje@users.noreply.github.com","commits":3,"url":"https://github.com/pskdje"},{"name":"Pesy Wu","username":"","email":"GamerNoTitle@outlook.com","commits":1},{"name":"z0z0r4","username":"z0z0r4","email":"z0z0r4@outlook.com","commits":3,"url":"https://github.com/z0z0r4"},{"name":"Roberta001","username":"Roberta001","email":"112218924+Roberta001@users.noreply.github.com","commits":1,"url":"https://github.com/Roberta001"}],"changelog":[{"hash":"a245b8189eb6e381bf520c2f93b6ae2e3495d0c9","time":1754477495000,"email":"112218924+Roberta001@users.noreply.github.com","author":"Roberta001","message":"更新开始直播 api 鉴权和更新直播姬版本号获取接口 (#1351)","coAuthors":[{"name":"z0z0r4","email":"z0z0r4@outlook.com"}]},{"hash":"2ecfe2aa82f161ea6c0edbf1c224c21783b38f8e","time":1752447497000,"email":"77605497+pskdje@users.noreply.github.com","author":"pskdje","message":"添加直播信息流和开关播的强制需求 (#1323)"},{"hash":"daf323bbd67377c0e469ba33bf04523edd3f03a1","time":1751100861000,"email":"z0z0r4@outlook.com","author":"z0z0r4","message":"Update manage.md"},{"hash":"29dbf5f264a4ee1370d9aa459e31901aeba4aad2","time":1751098423000,"email":"z0z0r4@outlook.com","author":"z0z0r4","message":"Update manage.md"},{"hash":"438425a282b8989b40b3037f2dda06de3a355ea1","time":1750931158000,"email":"77605497+pskdje@users.noreply.github.com","author":"pskdje","message":"更新直播间管理,添加直播回放,更新直播信息流 (#1298)","coAuthors":[{"name":"Pesy Wu","email":"GamerNoTitle@outlook.com"}]},{"hash":"3a2c9ce62cc25c9b12a8b42c21a5c7cbb2bf68c6","time":1747366379000,"email":"77605497+pskdje@users.noreply.github.com","author":"pskdje","message":"更新直播间管理文档,更新开关播响应信息"},{"hash":"40eb44fd66cbdc80377fdce57b96cd7cd7b60f2a","time":1743930843000,"email":"51024916+YuHuanTin@users.noreply.github.com","author":"YuHuanTin","message":"Update manage.md"},{"hash":"18c1efbc102ae6b44c8f5314c90e5e64f0d926cd","time":1721909032000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: bili_ticket 算法 Java 实现 及 信息补充 及 错误修正 (#1061)"},{"hash":"70eb85210189c3b0a29ebaeb0480436b85a3f2ae","time":1720611636000,"email":"Admin@fungit.org","author":"Kro","message":"添加 开通直播间 (#1050)"},{"hash":"372ffffa45410865ebbe4f71719324b0c7cda868","time":1719496807000,"email":"153351521+jaxMineKa@users.noreply.github.com","author":"賈驍明","message":"添加开播状态码60013 (#1042)"},{"hash":"def57d7a70ed1f39080069ba0f40648ce6ce2b90","time":1696914822000,"email":"catlair@qq.com","author":"LaMerChiang","message":"修复某些表格全角&半角符号不分 (#838)"},{"hash":"92b30f354ab21b97fe52357161fd04e2ca687c97","time":1693842068000,"email":"catlair@qq.com","author":"LaMerChiang","message":"fix: 修正文档中存在的错误路径,标签和目录 (#806)"},{"hash":"8ba78600ff105a8003f2ed3eb220b5535a0a7cd1","time":1690251142000,"email":"51156988+NoahCodeGG@users.noreply.github.com","author":"NoahCode","message":"✨ feat(直播间管理 API): 添加更新公告与标签 API (#752)"},{"hash":"f6760f4be38d5b592d396b211e48c666286524de","time":1677124138000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🔨remove header index"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/live/manage.md"}');export{m as comp,b as data};
|